了解REST响应和HTTP状态代码

Question

我想知道在REST API中应该如何响应。

有效示例：

http://blah.com/api/v1/dosomething/123

以上是一个有效的请求，当前我的HTTP状态为200，有一个JSON响应

{
    "dosomething": {
        "status": "OK",
        "results": "123"
    }
}

http://blah.com/api/v1/dosomething/123a

{
    "dosomething": {
        "status": "ERROR",
        "errors": [
            "Value passed: |123a| must be a integer."
        ]
    }
}

Answer 1

用404。总是。404.否则就会误解URI和资源的性质。如果http://blah.com/api/v1/doSomething/标识了资源，并且123a只是它的一个参数，那么其他代码就有意义了。但是它没有:http://blah.com/api/v1/dosomething/123标识资源。如果不存在这样的资源，则返回404Not found。

您可能拥有处理资源http://blah.com/api/v1/dosomething/123和http://blah.com/api/v1/dosomething/123a的一些实现细节，但它不是资源。来自罗伊·菲尔丁的论文：

“资源不是存储对象。资源不是服务器用来处理存储对象的机制。资源是一个概念映射--服务器接收标识符（标识映射）并将其应用于当前映射实现（通常是特定于集合的深度树遍历和/或哈希表的组合），以查找当前负责的处理程序实现，然后处理程序实现根据请求内容选择适当的操作+响应。所有这些特定于实现的问题都隐藏在Web界面后面；它们的性质不能由只能通过Web界面访问的客户机来假设。“