TrueURL
TrueURL

菜单

201 已创建

请求成功并创建了新资源,通常出现在 POST 或 PUT 之后。如果带有 Location 响应头,它指向新创建的资源。

原因短语
Created
是否重定向
否
默认可缓存
否

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 方法。

URL 重定向检测

使用免费的 TrueURL 重定向检测工具,逐跳查看一个 URL 返回的每一个状态码。