虽然 HTTP 协议是基于 RESTful 风格设计的，但不是用了 HTTP 协议的 API 就能叫做 REST API 。
Fielding 一直都不承认现在的 REST API ，认为它们只能叫做 HTTP API 或是 JSON RPC ，还曾经点名过微软的 REST API 。

文章里提到的超媒体驱动是我认为现在 REST API 最难达到的一点，Github 的 REST API 是我认为最接近的，但它仍然需要文档的帮助。
在 Fielding 的理念中，难道你访问一个网页，还需要有个网页使用手册来帮助你理解吗？网页有变更，难道要通知用户去查看新的手册吗？这些都是现在 API 的问题。
在我看来，目前（好几年没关注了，认知停留在 2019 年）的 OpenAPI 或者是 JSON Schema 这些规范提供的描述性格式都不足以达到文档的效果，所以也很难去掉文档的辅助，更别提客户端动态适应 API 的修改了。