HTTPプロトコルの仕組み
Webシステムは、クライアント(ブラウザやスマホアプリ)からのリクエスト(要求)に対し、サーバーがレスポンス(応答)を返すHTTP通信によって成り立っています。
主要なステータスコード
サーバーの処理結果を示す3桁の数値です。
| コード範囲 | 分類 | 代表的なステータスコード |
| 200番台 | 成功 | 200 OK(正常完了), 201 Created(リソース作成成功) |
| 300番台 | リダイレクト | 301 Moved Permanently(恒久移動), 304 Not Modified(キャッシュ利用) |
| 400番台 | クライアントエラー | 400 Bad Request(不正要求), 401 Unauthorized(未認証), 403 Forbidden(認可なし), 404 Not Found(存在しない) |
| 500番台 | サーバーエラー | 500 Internal Server Error(サーバー内部エラー), 503 Service Unavailable(過負荷・過多) |
HTTPヘッダーとボディ
- HTTPヘッダー:
Content-Type: application/jsonやAuthorization: Bearer <token>のようにメタデータを送受信します。 - HTTPボディ: 登録用フォームデータやJSONデータ本体が含まれます。
REST APIの設計原則
REST(Representational State Transfer)は、Webサービスの拡張性や可読性を高めるためのアーキテクチャ設計標準です。
- 直感的なURI設計: 名詞複数形を使い、操作内容をURIに含めない(◯
/users, ×/get_users) - HTTPメソッドの使い分け:
GET: リソースの取得(取得のみで副作用を持たない)POST: 新規リソースの作成PUT/PATCH: リソースの更新(PUTは完全置換、PATCHは一部更新)DELETE: リソースの削除

コメント