HTTP 与 Web 标准 / 系统课时
区分 Content-Type 与 Accept
区分 Content-Type 与 Accept
调用 JSON 接口时,最常见的 Header 错误不是字段拼错,而是把“我发送的是什么”和“我希望收到什么”写反。掌握 Content-Type 与 Accept 的方向后,就能更快判断 415、406 以及响应格式不符合预期的问题。
学习目标
- 判断请求与响应中的
Content-Type分别描述哪一段消息体。 - 使用
Accept表达客户端可接受的响应媒体类型。 - 根据 415、406 等现象定位媒体类型配置问题。
两个 Header 分别描述什么
Content-Type 描述当前这条 HTTP 消息所携带的内容是什么格式。它既可以出现在请求中,也可以出现在响应中:请求里的 Content-Type 描述请求体,响应里的 Content-Type 描述响应体。
Accept 则是请求 Header,表达客户端对响应表示形式的偏好。最简单的判断方法是:Content-Type 看“已经装进消息体的内容”,Accept 看“希望服务器返回什么”。
| Header | 方向 | 典型含义 |
|---|---|---|
Content-Type: application/json |
请求或响应 | 当前消息体是 JSON |
Accept: application/json |
请求 | 客户端希望响应优先使用 JSON |
Accept: */* |
请求 | 客户端可接受任意媒体类型 |

一次 JSON 请求怎么读
片段示例:假设 api.example.test 的 /users 接口约定,创建成功时返回 201,响应体仍为 JSON,并原样返回提交的 name。运行时需把 <PORT> 替换为实际端口。
curl -i -X POST "http://api.example.test:<PORT>/users" -H "Content-Type: application/json" -H "Accept: application/json" --data '{"name":"Ada"}'预期结果
HTTP/1.1 201 Created
Content-Type: application/json
{"name":"Ada"}这里两个 Header 不重复:请求 Content-Type 告诉服务器如何解析 {"name":"Ada"};Accept 告诉服务器客户端希望响应也使用 JSON;最终响应里的 Content-Type 再确认服务器实际返回的是 JSON。
配错时为什么会出现 415 或 406
当请求体确实是 JSON,却把 Content-Type 写成 text/plain,服务器可能无法选择正确的解析器,因此常见结果是 415 Unsupported Media Type。这类错误发生在“服务器无法按声明格式理解请求体”。
Accept 方向相反。如果客户端只接受某种表示形式,而服务器没有可提供的匹配表示,常见实现会返回 406 Not Acceptable;服务器也可能按自身协商策略忽略该偏好并返回默认表示,因此仍要结合接口契约判断。
选择 Header 时只问两个问题
发送请求体前先问“我现在发送的内容是什么格式”,答案写进请求 Content-Type;再问“我希望收到什么格式”,答案写进 Accept。收到响应后,则以响应 Content-Type 判断实际返回格式,而不是反过来根据 Accept 假定服务器一定照做。