201 已建立

HTTP **201 已建立** 成功響應 狀態碼錶示 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 已建立 響應將如下所示

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

另請參閱