如果REST API返回JSON，那么MIME类型是什么？

Question

我的REST API返回JSON。

我目前正在返回text / plain作为MIME类型，但感觉很有趣。我应该返回application/x-javascript还是其他类型？

第二个问题是关于错误条件的HTTP状态代码。如果我的REST API返回错误状态，我将返回JSON

{ result: "fail", errorcode: 1024, errormesg: "That sucked. Try again!" }

HTTP状态代码应保留在200 OK吗？

Answer 1

JSON规范建议application/json，这似乎得到IETF和IANA注册表的支持。

关于第二个问题，我认为如果消息处理以某种方式失败，您应该将结构化和标准错误响应作为JSON消息返回;只有当您考虑HTTP错误代码时，由于某种原因未能将消息传递给后端处理程序。

更新2014-06-27：客户端（浏览器）仅使用200响应的日子早已过去，RESTful API的主流建议是使用适合响应的HTTP响应代码，2xx用于成功响应（例如201创建的对于所有错误条件，包括来自API本身的错误条件，PUT; 204 No DELETE内容）和4xx和5xx。

Answer 2

JSON的MIME类型是

application/json

http://www.ietf.org/rfc/rfc4627.txt

http://www.iana.org/assignments/media-types/application/

更具体地说：

http://www.ietf.org/rfc/rfc4627.txt

Answer 3

我更喜欢回复HTTP错误状态和特定于应用程序的有效负载。

Answer 4

不，你不应该在错误的情况下返回200。

可以重复状态代码，或在响应有效负载中包含更详细的错误代码。

Answer 5

根据Content-type的说法，返回的正确application/json是RFC 4627，它也注册了IANA的MIME类型（事实上，它显示在IANA的页面上）。当然，如果你要写一个客户，你会希望在你所接受的内容中更加自由，并且也接受其他人如text/json和text/x-json。

现在，如果出现错误，则不应返回HTTP 200，这基本上不是RESTful。我知道有时候你的错误并不完全匹配，但是在RFC 2616 Sections 10.4-10.5中选择最接近的4XX（客户端故障）或5XX（服务器故障）错误，并且在JSON中更准确。

Answer 6

如果“REST API”表示您希望遵循REST体系结构，那么要使用的媒体类型取决于您希望通过REST API公开的功能。您想要能够创建新对象吗？查询对象列表？编辑一个对象？如果是这样，那么一个好的RESTful媒体类型可能是vnd.collection + json，因为它定义了一个超文本链接接口来操作json对象的集合。

注意：RESTful API可以使用媒体类型application / json，但是这种媒体类型没有超文本链接的RESTful接口，因此它将成为状态更改的终点。

遵循Web API体系结构也是完全可以接受的，其中HTTP RPC调用返回application / json对象，而其他HTTP RPC调用操作这些对象，并且没有用于使用和导航状态更改的超文本链接接口。但这不是REST。

我喜欢REST的描述（来自REST的创建者）：

REST APIS must be hypertext driven

换句话说，如果应用程序状态的引擎（以及API）不是由超文本驱动的，那么它就不能是RESTful，也不能是REST API。期。

此外，从该帖子的讨论是这个RESTful应用程序的例子：Lost Boys's Spam-E REST Application