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