JSON API规范 - 服务器责任说明

时间:2015-11-02 19:37:42

标签: json types parameters media specifications

有人可以向我解释JSON API规范中提到的以下三点所期望的内容吗?

  

服务器必须使用标题Content-Type:application / vnd.api + json在响应文档中发送所有JSON API数据,而不使用任何媒体类型参数。

我已经理解了第一部分,它提到需求的响应将Content-Type标头设置为application/vnd.api+json,但我无法理解without any media type parameters.部分。

  

如果请求指定带有任何媒体类型参数的标题Content-Type:application / vnd.api + json,则服务器必须使用415 Unsupported Media Type状态代码进行响应。

在提及media type parameters时再次丢失。

  

如果请求的Accept标头包含JSON API媒体类型,并且使用媒体类型参数修改了该媒体类型的所有实例,则服务器必须使用406 Not Acceptable状态代码进行响应。

1 个答案:

答案 0 :(得分:5)

嗯,媒体类型与“内容类型”几乎相同,只是有一些额外的提及,例如:

Content-Type: text/html
Content-Type: text/html; charset=UTF-8
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  1. 他们说除了

    之外什么都不回应

    Content-Type: application/vnd.api+json

  2. 他们说请求Content-Type:标题不是application/vnd.api+json,然后回复

    Status: 415 Unsupported Media Type

  3. 他们说请求Accept:标题不是application/vnd.api+json然后回复

    Status: 406 Not Acceptable

  4. 注意: 它们也意味着没有变体,例如

    Content-Type: application/vnd.api+json+gzip
    

    不可接受