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

関連情報