RESTful 有用吗？ HTTP 有 GET POST 就足够了？

不少程序员都是这么认为的，基于 HTTP API 的服务，只要用 GET 请求和 POST 请求就足够了。像 RESTful 这样的大量使用 PUT ， DELETE 请求是不必要的。

真的吗，我来举一个例子。

假设有一类资源 ResourceXYZ ，对其有增删查改的操作。如果只使用 GET POST 之类的设计方式，那么很可能会设计以下的请求接口：

POST .../addResourceXYZ
POST .../delResourceXYZ
GET .../getResourceXYZ?resourceId=resourceId
POST .../updateResourceXYZ

如果按照 RESTful 的设计方式，很可能会设计以下的请求接口

POST .../ResourceXYZs
DELETE .../ResourceXYZ/{resourceId}
GET .../ResourceXYZ/{resourceId}
PUT .../ResourceXYZ/{resourceId}

现在假设，客户端要获取该资源，其 ID 为 resourceId 。如果成功，那么一切都好说。如果失败， Restful 的处理方式是，通过 HTTP status 返回错误码来表示原因，例如 404 表示该资源不存在。

那么只用 GET POST 两种方法的方式呢？响应请求

GET .../getResourceXYZ?resourceId=resourceId

的时候能不能也用 404 呢？

按照 404 的语义，响应 404 是不对的：因为客户端请求的 URL 实际上是正确的，只是对应的参数没有找到对应的结果很多时候，就只能靠响应 200 然后返回空数据或者空对象来处理了。例如 Content-type 为 application/json 时，可以返回 {} 或者

{
    "error": "not found",
    "code": 404
}

这样就会要求客户端，必须处理 HTTP 回复的具体内容，而不能只处理头部。那么客户端要怎么处理这个 json 呢要先解析 json ，然后尝试分别这是一个资源的内容，还是一个错误提示。

对于强类型语言例如 C/C++ OC Swift 写的客户端来说，恐怕就忍不住要问候服务端程序员一家了。

更重要的是……

没有库会支持这种拍脑袋式的设计。

全文完，欢迎拍砖。

noli

2017-02-15 17:39:44 +08:00

@Sight4

1. 因为很多人根本没有操刀设计 API 的水平。别说 RESTful 了，我厂也算知名互联网企业，某 C++ SDK 出品一样是个渣渣。 RESTful 要考虑的更多难度更高，但说 RESTful 会导致实现别扭…… 呵呵

2. HTTP 返回码和回复里面的返回码，通常其含义不应该是冲突的，诸如 HTTP 200 但是 "code": 404 这种只能说某些人自以为很了解 HTTP 协议及其客户端。

3. 不用 HTTP method ，那么基本上就是把动作写在 URL 里面，这种设计我觉得见仁见智，有些时候是很省事，但通常深挖一下就会发现是解耦不够。
更重要的是，这基本上等于放弃了各种 RESTful client SDK 带来的好处。
那还不如直接点干脆不用 HTTP

所以我觉得你说了很多没有经过深入思考的经验，但基本上是废话。