问标头值: application/vnd.api+json

EN

媒体类型application/vnd.api+json引用JSON。你可以读到它，在这里非常详细。

简而言之，JSON是一种固执己见、推理充分的API：

…客户端应该如何请求获取或修改资源，以及服务器应该如何响应这些请求。

供应商前缀(vnd.)指示此供应商是自定义的。+json表示它可以被解析为JSON，但是媒体类型应该在JSON之上定义进一步的语义。

第一个是特定于API的媒体类型。供应商前缀(vnd.)表示它是此供应商的自定义。+json表示它可以被解析为JSON，但是媒体类型应该在JSON之上定义进一步的语义。

第二个只是意味着内容是JSON。但是，这通常并不十分有用，因为它没有定义JSON值的含义。

阅读这方面的一个很好的起点是在维基百科上，但是要了解更多细节，您可以始终按照那一页上相应的RFCs的链接进行操作。

如果您不确定，请使用application/json --这是一般的MIME类型，它只要求返回的数据为格式良好的JSON。

application/vnd.api+json MIME类型保留用于使用(名称混乱的) "JSON API“协议进行通信。

在这个上下文中，"JSON“指的是而不是，指的是基于HTTP的任何API。它也不是一个完全指定的API，而是用于构建允许客户端获取和修改相关实体的API的框架。例如，博客应用程序可以实现一个符合"JSON“规范的API，该API允许由给定的作者在单个HTTP请求中获取最后10篇文章，其中包含每篇文章的元数据和注释。

该规范特别界定：

• 形成请求的具体方式(即URL参数控制、排序和分页以及输出中包含的数据)；
• 响应中JSON文档的特定结构，例如：

文档必须至少包含下列顶级成员之一：

• data：文档的“主数据”
• errors：一个错误对象数组
• meta：包含非标准元信息的元对象.

成员data和errors不能共存在同一个文档中。