绝大部分的 RESTful API 都不是真正的 REST | most restful api are not rest

绝大部分的 RESTful API 都不是真正的 REST | most restful api are not rest

Subscribe:
页面内有广告,如果你看不到说明你在用广告拦截插件,为了网站能够持续运营,请顺手将本网站加到广告拦截白名单中,感谢!


提出 REST 概念的论文作者当初对于 REST 的定义和现在人们理解的 RESTful API 并不一样,可以这么说,你开发的,见过的所谓 RESTful API 都不是论文作者定义的 REST,而只是基于 HTTP 的 applicaion/json API.

作者认为真正的 REST 核心概念就像一个浏览器书签一样,你只需要知道其中一个入口 API, 剩下的所有功能都应该通过这个及后续 API 的响应中获取。

举个例子,你 POST /users 创建一个用户,这个 API 就应该返回给你 self: GET /users/1, activate: POST /users/1/activate, order list: GET /users/1/orders ...

一切 resource 的访问地址都应该由服务端在响应里告诉客户端,而不需要客户端查看 API 文档。

我好像只见过某个支付系统的 API 是这么设计的,忘了是 Paypal 还是 Stripe 还是其他的平台了...

florian-kraemer.net//software-