Roy Fielding 的那篇论文提了一个概念，你给一个用户一个 web 页面，不需要教他，他拿过来就会用，web page 是自解释的。但是给一个客户端一个 API 文档，它是无法自己学会怎么用 API 的，要有人理解文档并写对应的代码，客户端才知道要请求哪个 API 。API 不是自解释的。

在 REST 里，资源和操作被分开了，比如客户端请求一个 aaa，返回一堆 bbb，那客户端可以推测出要添加新的 bbb 资源，就要请求 POST /bbb，要删除一个 bbb 资源，就要请求 DELETE /bbb，要更新 bbb 资源，就要请求 PUT /bbb 或者 PATCH /bbb，客户端不需要理解 aaa 和 bbb 分别是什么玩意。在 REST 的模型中，资源可以是任意的东西，但是操作已经被限定了。这样如果有一个通用 REST Client，它就可以适用于所有编写得当的 REST API 。而这个通过不同的 HTTP 动词，改变资源状态的模型，就叫 Representational state transfer

说回现实世界的 REST，我觉得 Roy 的本意并没有得到实现，现在的 RESTful API 跟他的期望相距甚远，只是一个规范而已，并没有巨大的好处。