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: */* 请求 客户端可接受任意媒体类型

Content-Type 与 Accept 的方向关系

一次 JSON 请求怎么读

片段示例:假设 api.example.test 的 /users 接口约定,创建成功时返回 201,响应体仍为 JSON,并原样返回提交的 name。运行时需把 <PORT> 替换为实际端口。

bash
curl -i -X POST "http://api.example.test:<PORT>/users" -H "Content-Type: application/json" -H "Accept: application/json" --data '{"name":"Ada"}'

预期结果

http
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 假定服务器一定照做。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分 Content-Type 与 Accept

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通