HTTPメソッド

HTTPリクエストにおけるメソッドとは、リクエストが「何をしたいのか」という操作の種類を示すものです。代表的なメソッドには、GET、POST、PUT、DELETEがあります。

1. 代表的なHTTPメソッドの種類

1.1 GET

GETメソッドは、サーバからリソースやデータを取得するときに使用されます。例えば、ユーザの一覧を取得したり、特定のIDを持つユーザデータを取得する場合などに利用されます。

GET /users HTTP/1.1

この例では、/usersに対してGETリクエストを送信しています。サーバはユーザの一覧データをレスポンスとして返します。

1.2 POST

POSTメソッドは、主にリソースやデータを作成するときに利用されます。新しいユーザの登録やタスクの作成を行う場合などに使用されます。作成するデータはリクエストのボディに格納してサーバに送信されます。

POST /users HTTP/1.1
Content-Type: application/json

{"name": "田中太郎", "email": "tanaka@example.com"}

この例では、/usersに対してPOSTリクエストを送信し、ボディに新しいユーザの情報をJSON形式で含めています。サーバはこのデータをもとに新しいユーザを作成します。

1.3 PUT

PUTメソッドは、特定のリソースやデータを更新するときに利用されます。例えば、既存のユーザ情報を変更したい場合などに使用されます。POSTと同様に、データをリクエストのボディに含めてサーバに送信します。

PUT /users/1 HTTP/1.1
Content-Type: application/json

{"name": "田中次郎", "email": "jiro@example.com"}

この例では、/users/1(IDが1のユーザ)に対してPUTリクエストを送信し、ボディに更新後のデータを含めています。サーバはIDが1のユーザの情報を、送信されたデータで更新します。

1.4 DELETE

DELETEメソッドは、特定のリソースやデータを削除する場合に利用されます。例えば、登録済みのタスクを削除したい場合などに使用されます。

DELETE /users/1 HTTP/1.1

この例では、/users/1(IDが1のユーザ)に対してDELETEリクエストを送信しています。サーバはIDが1のユーザを削除します。DELETEリクエストでは、通常ボディは含めません。

💡 ポイント
リクエストのパスとHTTPメソッドの組み合わせにより、サーバ側で実行される処理の振り分けが行われます。この仕組みをルーティングと呼びます。

HTTPメソッドの一覧をまとめると以下のとおりです。

メソッド 操作 ボディ リクエスト例
GET データの取得 なし GET /users
POST データの作成 あり POST /users
PUT データの更新 あり PUT /users/1
DELETE データの削除 なし DELETE /users/1