我刚刚完成了一项用于缩短 URL 的在线服务(在带有 Zend Framework 的 php5 中);您可以输入一个 URL,然后您会得到一个短 URL(例如tinyurl 等网站)。
我正在考虑为开发人员提供 API - 目前您可以使用 SOAP 向服务发送 URL,但我不确定这是否是一个好的解决方案。此类服务的最佳实践是什么?休息?肥皂?两者都?
我会限制自己休息,因为整个“API”只是两次调用(返回长网址或短网址,反之亦然)。
绝对是 REST - SOAP 的开销是不必要的,除非您正在构建一个特别安全的企业 URL 缩短服务(我认为这可能是一个矛盾)。 bit.ly API 非常好,值得一试。
在这种情况下,我会说一直采用 REST,SOAP 对此来说太过分了,除了增加网络负载之外什么也没有。该 API 足够简单,文本描述就足够了,尽管您可能想查看 WADL
同时投票支持 REST,因为 SOAP 对于这个小型 API 来说是一个巨大的野兽并且杀伤力过大。另外,所有流行的 url 缩短服务都使用 REST。您甚至应该考虑靠近更流行的服务之一,因为这可能有助于开发人员更轻松地添加您的服务;)
如果您正在考虑 URL 缩短服务的 API 设计,那么使用 REST 绝对是一个好方法。由于它易于开发人员集成,因此受到广泛青睐。
Smler 使用轻量级且对开发人员友好的 RESTful API。以下是典型请求的样子:
curl -X POST https://api.smler.com/v1/shorten \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"long_url": "https://your-long-url.com",
"custom_alias": "optional-custom-alias"
}'
REST 允许您使用标准 HTTP 方法和 JSON 有效负载,使开发人员更容易采用并集成到他们的项目中。虽然在某些特定情况下仍然使用 SOAP,但 REST 通常更通用且更易于调试。