含义
请求成功并创建了新资源。Location 头通常指向这个新资源。
常见原因
- 向集合 POST 创建了一条记录
- PUT 在新 URL 上创建了资源
解决方法
客户端或访问者
从 Location 头获取新资源的 URL；如果 API 在响应体中返回了创建的对象，也可以直接使用。
网站或 API 的维护者
带上指向新资源的 Location，最好同时返回创建后的表示。没有创建任何东西时不要返回 201；幂等重试发现已存在的条目时可以返回 200 或 409。
响应示例
HTTP/1.1
HTTP/1.1 201 Created
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Location: /users/42
Content-Type: application/json
{
"id": 42,
"name": "Ada"
}规范
常见问题
› 201 必须带 Location 头吗？
强烈建议带上。没有它，客户端只能从响应体里猜新资源的 URL。
› 201 和 202 有什么区别？
201 表示资源此刻已经存在；202 表示请求已被接受，稍后才会处理。