201 Created 表示请求已完成,并创建了一个或多个新资源。API 通常在向集合发送 POST 或向新 URL 发送 PUT 之后返回它。主要的新资源由 Location 响应头标识;如果没有 Location,则由请求 URL 标识。
响应体通常会描述新资源,或给出指向它的链接。响应中的 ETag 等验证器适用于新创建的表示(representation),客户端可以在之后的条件请求中使用它们。
与 3xx 响应不同,201 中的 Location 响应头并不是重定向,浏览器和 HTTP 客户端不会自动跟随。
响应示例
HTTP
HTTP/1.1 201 Created
Date: Fri, 06 Nov 2026 10:15:32 GMT
Location: https://api.example.com/v1/orders/8412
Content-Type: application/json
Content-Length: 30
{"id":8412,"status":"pending"} SEO 与重定向检测
201 属于 API 和表单处理程序,而不是需要编入索引的页面。爬虫收到它时会视为成功,但公开页面的 URL 应返回 200。在浏览器中提交表单之后,通常的做法是改为返回 303 See Other,这样刷新结果页时就不会再次提交表单。
常见原因与使用场景
- REST API 创建了一条记录(
POST /orders),并在Location中返回其 URL。 - 通过
PUT将文件上传到一个此前不存在的 URL。 - 重定向检测显示某个本应是页面的 URL 返回了 201:这个端点其实是 API,或者检测时使用了 POST。请在高级设置中检查 HTTP 方法。