201 Created
HTTP 201 Created 成功響應狀態碼錶示 HTTP 請求已導致建立了一個資源。此狀態碼通常作為 POST 請求的結果傳送。
新的資源，或對新資源的描述和連結，會在響應返回之前建立。新建立的項可以在響應訊息的正文中返回，但必須可以透過發起請求的 URL 或透過響應中提供的 Location 標頭的值中的 URL 來定位。
狀態
http
201 Created
示例
接收表示使用者建立的響應
假設有一個用於管理使用者的 REST API，其端點位於 http://example.com/users。在此示例中，我們傳送一個帶有以下正文的 POST 請求來建立使用者
http
POST /users HTTP/1.1
Host: example.com
Content-Type: application/json
{
"firstName": "Brian",
"lastName": "Smith",
"email": "brian.smith@example.com"
}
使用者成功建立後，201 Created 響應將如下所示
http
HTTP/1.1 201 Created
Content-Type: application/json
Location: http://example.com/users/123
{
"message": "New user created",
"user": {
"id": 123,
"firstName": "Brian",
"lastName": "Smith",
"email": "brian.smith@example.com"
}
}
規範
| 規範 |
|---|
| HTTP 語義 # status.201 |