WebアプリはHTTPプロトコルで通信します。HTTPの仕組みとREST APIの設計方針を理解することは、バックエンド開発の基礎となります。
HTTPメソッドの種類
| メソッド | 用途 | 例 |
|---|
| GET | データの取得 | ユーザー一覧を取得 |
| POST | データの作成 | 新規ユーザーを作成 |
| PUT | データの全体更新 | ユーザー情報を丸ごと更新 |
| PATCH | データの部分更新 | ユーザー名だけ更新 |
| DELETE | データの削除 | ユーザーを削除 |
HTTPステータスコード
| コード | 意味 | 場面 |
|---|
| 200 OK | 成功 | GETやPUTが成功 |
| 201 Created | 作成成功 | POSTで新規作成が成功 |
| 400 Bad Request | リクエストが不正 | 必須パラメータが不足 |
| 401 Unauthorized | 認証が必要 | ログインが必要なAPI |
| 403 Forbidden | 権限なし | アクセス禁止 |
| 404 Not Found | 見つからない | 存在しないURLへのアクセス |
| 500 Internal Server Error | サーバーエラー | バックエンドで予期しないエラー |
RESTful APIの設計原則
| 操作 | URL例 | メソッド |
|---|
| 一覧取得 | /api/users | GET |
| 1件取得 | /api/users/1 | GET |
| 作成 | /api/users | POST |
| 更新 | /api/users/1 | PUT / PATCH |
| 削除 | /api/users/1 | DELETE |
curlでAPIを試す
curl -X GET https://api.example.com/users
curl -X POST https://api.example.com/users \
-H "Content-Type: application/json" \
-d '{"name": "Taro", "email": "taro@example.com"}'
まとめ
- HTTPメソッドはGET（取得）・POST（作成）・PUT（更新）・DELETE（削除）が基本
- ステータスコードで処理結果を表す（200=成功、4xx=クライアントエラー、5xx=サーバーエラー）
- REST APIはリソースをURLで表しHTTPメソッドで操作する設計方針
コメント