意義
請求成功並建立了新資源。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 表示請求已被接受，稍後才會處理。