计算机网络 / 系统课时

提交 JSON 数据

提交 JSON 数据

向 HTTP 接口发送对象时,关键不是“把一段 JSON 放进请求体”这么简单,而是同时保证序列化结果合法、Content-Type 正确,并能用响应验证服务器确实按 JSON 解析。下面用 curl 完成一条可复现的 POST 请求。

学习目标

  • 正确设置 Content-Type: application/json 并发送 JSON 请求体。
  • 区分 JSON 文本、表单字段与普通字符串的传输差异。
  • 通过回显响应检查请求头和结构化请求体是否被正确解析。

请求体与媒体类型要同时正确

JSON 请求通常包含两部分:请求头声明媒体类型,请求体放 UTF-8 JSON 文本。只有请求体看起来像 JSON、却写成 Content-Type: text/plain,服务器框架可能不会进入 JSON 解析器;反过来声明 JSON 却发送非法文本,也常得到 400 或 415。

一条最小请求可按下面的 HTTP 语义理解:方法是 POST,媒体类型是 application/json,主体是一个完整 JSON 对象。字段名和字符串必须使用双引号,不能把 JavaScript 对象字面量直接当成 JSON。

JSON 请求从客户端序列化到服务端解析的流程

用 curl 发送一条 JSON POST 请求

下面示例使用公开回显端点 https://httpbin.org/post。--data-binary 会按给定内容发送请求体,-H 显式设置媒体类型,适合观察“头部声明”和“正文内容”这两个要点。

bash
curl -sS https://httpbin.org/post \
  -H 'Content-Type: application/json' \
  --data-binary '{"name":"Ada","age":36,"active":true}'

预期结果:响应 JSON 的关键字段应包含服务器解析出的 json 对象;响应还会带有其他回显字段,所以完整内容会比下面更多。

json
{
  "json": {
    "active": true,
    "age": 36,
    "name": "Ada"
  }
}

如果使用 curl 7.82.0 及以上,也可以用 --json '{"name":"Ada"}';它会自动添加 JSON 相关请求头。教学或排错时仍建议先显式写 Content-Type,这样更容易看清请求到底发了什么。

发送前先检查序列化结果

程序里的对象必须先序列化成 JSON 文本。浏览器或 Node.js 中应使用 JSON.stringify;不能把对象隐式转成字符串,否则常得到 [object Object],这不是合法 JSON。

js
const payload = { name: "Ada", tags: ["http", "json"], active: true };
const body = JSON.stringify(payload);

console.log(body);
console.log(JSON.parse(body).tags[1]);

预期输出:

text
{"name":"Ada","tags":["http","json"],"active":true}
json

实际发送时,还要把 body 作为请求体并配合 Content-Type: application/json。若服务端返回 400 Bad Request,先打印最终字符串再用 JSON 解析器验证;不要只检查源代码里的对象。

常见失败从状态码和回显定位

400 常表示请求体不是合法 JSON,例如尾随逗号、漏引号或截断;415 Unsupported Media Type 常表示接口要求 JSON,但请求没有使用它接受的媒体类型。具体状态码仍由服务端实现决定,应以接口文档和响应体为准。

排查时按固定顺序检查:先确认请求方法与 URL,再看 Content-Type,最后查看实际发送的原始请求体。若回显服务中的 json 为 null,而 data 中只是普通文本,通常说明正文没有被当作 JSON 解析。

发送 JSON 的判断标准很简单:线上抓包或回显中能同时看到正确的 Content-Type 与合法 JSON 正文,服务端又能得到预期字段和值,这条请求才算真正完成。

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

目录与阅读设置

阅读设置

17

记录一个想法

提交 JSON 数据

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

登录哪都通