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": "建立新使用者", "user": { "id": 123, "firstName": "Brian", "lastName": "Smith", "email": "brian.smith@example.com" } } 規範
| Specification |
|---|
| HTTP Semantics> # status.201> |