Web services REST样式API调用的输出中的状态字段应该是数字代码还是字符串?

Web services REST样式API调用的输出中的状态字段应该是数字代码还是字符串?,web-services,api,Web Services,Api,我有一个REST ish API,它返回JSON。其中一个输出字段是status,它指示调用是否成功。我推测使用数字状态码(如 200 success 400 syntax error 401 authentication error 402 general error 404 user not found 408 timed out 500 fatal error 501 not yet implemented 是否有任何原因(除了传输稍微少一些字节)使用数字代码而不是更多的描述性符号作为状

我有一个REST ish API,它返回JSON。其中一个输出字段是
status
,它指示调用是否成功。我推测使用数字状态码(如

200 success
400 syntax error
401 authentication error
402 general error
404 user not found
408 timed out
500 fatal error
501 not yet implemented
是否有任何原因(除了传输稍微少一些字节)使用数字代码而不是更多的描述性符号作为状态,如

success
syntax_error
auth_error
general_error
user_not_found_error
time_out_error
fatal_error
not_yet_implemented_error

指出备受尊敬的API中的现代先例会很有帮助。

只要它们是标准的(在您的应用程序中),并且为使用Web服务的用户的利益而记录,您就可以让它们成为您想要的

使用404等HTTP状态代码的好处是真正的REST Web服务基于HTTP传输,因此使用公认的标准是有意义的

这就是说,您可能会发现HTTP/1.1状态代码并不完全合适-例如您的“404用户未找到”等同于“404未找到”-我认为只要含义存在就可以了

如果您必须创建全新的代码,那么值得坚持使用HTTP组—2xx用于可接受的结果,3xx用于所需的更改,4xx用于客户端错误,5xx用于服务器端错误。

明白了,谢谢!不是“真正的休息”,我想我不会担心数字代码。