1. ウェブ
  2. HTTP
  3. リファレンス
  4. HTTP レスポンスステータスコード
  5. 201 Created

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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

仕様書

仕様書
HTTP Semantics
# status.201

関連情報

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告