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 |