index.md

title	slug	l10n
201 Created	Web/HTTP/Status/201	sourceCommit 3f68a9604259dfa862dd741dc88ebc8fb5fa10fe

{{HTTPSidebar}}

HTTP の 201 Created は成功レスポンスステータスコードで、 HTTP リクエストが成功してリソースの作成が完了したことを表します。 このステータスコードの一般的な使用例は、 {{HTTPMethod("POST")}} リクエストの結果です。

新しいリソース、または新しいリソースの説明とリンクは、レスポンスが返される前に作成されます。 新しく作成されたアイテムは、メッセージ本体に返され、位置は最初のリクエストの URL、またはレスポンスの {{HTTPHeader("Location")}} ヘッダーの値の URL のどちらかになります。

ステータス

201 Created

例

ユーザーを作成したことを示すレスポンスの受信

ユーザー管理用の REST API があり、エンドポイントが http://example.com/users であるとしましょう。この例では、ユーザーを作成するために、次の本体を持つ POST リクエストを送信します。

POST /users HTTP/1.1
Host: example.com
Content-Type: application/json

{
  "firstName": "Brian",
  "lastName": "Smith",
  "email": "brian.smith@example.com"
}

ユーザー作成に成功すると、 201 Created というレスポンスは以下のように表示されます。

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"
  }
}

仕様書

{{Specifications}}

関連情報

• HTTP リクエストメソッド
• HTTP レスポンスステータスコード