计算机网络 / 系统课时

使用 POST 提交数据

使用 POST 提交数据

POST 用来把数据提交给服务器处理,常见于创建资源、提交表单和触发一次操作。本节通过 JSON 请求掌握请求体与 Content-Type 的配合方式,并说明为什么重复 POST 可能产生多次效果,以及创建接口应怎样返回结果。

学习目标

  • 能使用 POST 和 JSON 请求体向接口提交结构化数据。
  • 能根据数据格式正确设置 Content-Type,并识别常见表单编码。
  • 能区分 POST 与幂等操作,并理解创建资源时常见的状态码与 Location 响应头。

把数据放进请求体

POST 的主要数据通常位于请求体,而不是查询字符串。提交 JSON 时,请求头应声明 Content-Type: application/json;传统 HTML 表单常使用 application/x-www-form-urlencoded,包含文件上传的表单通常使用 multipart/form-data。

下面向 httpbin 提交一个 JSON 对象,并只打印服务器解析出的 JSON。示例适用于安装了 curl 与 Python 3 的 Bash 环境。

bash
curl -s -X POST "https://httpbin.org/post" -H "Content-Type: application/json" -d '{"title":"HTTP 入门","published":true}' | python -c "import sys,json; print(json.dumps(json.load(sys.stdin)['json'], ensure_ascii=False, sort_keys=True))"

预期输出:

json
{"published": true, "title": "HTTP 入门"}

这里的 Content-Type 告诉服务器如何解释请求体。一个常见错误是发送 JSON 文本却声明 application/x-www-form-urlencoded,结果框架无法按预期解析字段。使用 curl -d 时如果没有手动指定 JSON 类型,curl 默认会采用表单相关的内容类型,因此提交 JSON 时应明确添加请求头。

创建资源时返回明确结果

POST 经常用于向集合创建新资源,例如客户端向 /articles 提交标题和正文。创建成功时,接口常返回 201 Created,并通过 Location 指出新资源地址,例如 Location: /articles/381。响应体还可以返回服务器生成的 ID、创建时间等字段。

201 不是所有 POST 的固定结果。同步执行普通操作可以返回 200 OK,服务器接受任务但稍后处理时常用 202 Accepted,成功且不需要响应正文时可以使用 204 No Content。状态码应描述实际处理结果,而不是机械地由 HTTP 方法决定。

例如创建文章可以约定请求为 POST /articles,成功后返回 201 和新资源地址;如果是发送一封邮件的操作,POST /messages/42/send 可能返回 202,表示服务器已经接收发送任务但尚未完成投递。

重复 POST 为什么需要特别处理

POST 本身没有幂等保证。假设 POST /orders 每次都会创建一张新订单,客户端因网络超时没有收到响应并自动重试,就可能从一次购买变成两张订单。服务器即使第一次已经成功,也不能仅凭“请求内容相同”判断第二次一定是重复请求。

支付、订单等不能重复创建的接口通常需要业务层的幂等机制。例如客户端生成唯一的幂等键,并在重试时保持该值不变;服务器保存该键与首次处理结果,后续收到相同键时返回原结果而不再次创建资源。具体头字段名称属于接口约定,并不是 HTTP 标准强制规定。

设计接口时可以直接检查三个问题:提交的数据格式是否与 Content-Type 一致;成功状态码是否反映真实处理阶段;同一个请求因为超时被重试两次时,业务是否允许产生两次效果。只要第三项答案是否定的,就应在应用层明确设计去重或幂等策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 POST 提交数据

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

登录哪都通