TrueURL
TrueURL

選單

201 已建立

要求成功並建立了新資源,通常發生在 POST 或 PUT 之後。若有 Location 標頭,它會指向新建立的資源。

原因短語
Created
是否為重新導向
否
預設可快取
否

201 Created 表示要求已完成,並建立了一個或多個新資源。API 通常會在對集合發出 POST,或對新網址發出 PUT 之後回傳它。主要的新資源由 Location 標頭指出;如果沒有 Location,則以要求網址為準。

回應主體通常會描述新資源,或提供連往它的連結。回應中的 ETag 等驗證器適用於新建立的表示法,用戶端可以在後續的條件式要求中使用它們。

與 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 和表單處理程式,而不是應該編入索引的網頁。爬蟲收到它時會視為成功,但公開網頁的網址應該回傳 200。在瀏覽器中送出表單後,常見的做法是改以 303 See Other 回應,這樣重新整理結果頁面時才不會再次送出表單。

常見原因與使用情境

  • REST API 建立了一筆紀錄(POST /orders),並在 Location 中回傳它的網址。
  • 以 PUT 將檔案上傳到原本不存在的網址。
  • 重新導向檢查對您以為是網頁的網址顯示 201:該端點其實是 API,或檢查時使用了 POST。請在「進階設定」中確認 HTTP 方法。

網址重新導向檢查

使用免費的 TrueURL 重新導向檢查工具,逐一查看網址在每個躍點回傳的狀態碼。