201 Created 【HTTP 201】

概要

HTTPステータスコードとは

WebサーバとWebクライアントの間では「HTTP」（Hypertext Transfer Protocol）という通信規約（プロトコル）でデータ伝送を行っている。クライアントからの要求（リクエスト）に対してサーバは応答（レスポンス）を返すが、その際に現在の状態を示す「HTTPステータスコード」を通知する。

ステータスコードは3桁の番号と簡易なメッセージで表される。番号の最上位桁は分類、下2桁は識別番号である。100番台は「情報」（Informational）、200番台は「成功」（Success）、300番台は「転送」（Redirection）、400番台は「クライアントエラー」（Client Error）、500番台は「サーバエラー」（Server Error）を表している。

201 Createdとは

201番は成功通知の一つで、メッセージは “Created”、すなわち、資源の作成が成功したことを示す。記事の投稿、ファイルのアップロード、データベースへのレコードの挿入、アカウント作成など、クライアントがPOSTメソッドやPUTメソッドで資源の作成を要求してきた場合に用いられる。

POSTメソッドの場合はHTTPレスポンスのLocationヘッダに資源のURLを書き入れてクライアントに通知する。レスポンスボディに作成した資源の内容を搭載して送り返すことが多いが、作成する資源の種類にもよるため必須ではない。