HTTP 400と422は、要求の問題を利用側へ伝える際に使われるコードです。400はクライアント側の問題とみなされる要求を広く扱い、422は内容の種類と構文を理解できても、含まれる指示を処理できない場合を表します。
APIの入力エラーを整理するときは、番号だけで原因を決めず、どの段階の検証に失敗したかを確認します。
400は構文エラーだけに限定されない
RFC 9110の400は、クライアント側の誤りとみなされる理由でサーバーが処理できない、または処理しない応答です。例には不正な構文、メッセージの区切り、誤ったルーティングなどがあります。
そのため、400が返ったら必ずJSONの括弧が壊れている、といった断定はできません。API仕様と応答の詳細を確認します。
422は形式を理解した後の処理不能を表す
RFC 9110の422は、要求内容の種類を理解し、構文も正しいものの、含まれる指示を処理できない状態を表します。
| 確認する段階 | 考える問い |
|---|---|
| 要求全体 | メソッド・URL・区切りなどが適切か |
| 内容の形式 | そのAPIが受け取れる種類・構文か |
| 入力の意味 | 必須項目・値の範囲・項目間の関係が条件を満たすか |
この表は調査順の整理です。個々の業務検証を必ず422へ割り当てる、という共通ルールではありません。
同じ番号でもAPIの契約を読む
仮に予約APIへ、開始日時より終了日時が前の値を送った場面を考えます。形式上は正しい日時でも、予約の条件を満たしません。こうした意味上の検証結果をどう伝えるかを、API設計で決めます。
利用側は、番号だけでなくエラーコード、対象項目、修正可能な内容を読みます。実装側は内部の例外情報や秘密値を返すことなく、利用者が直すために必要な説明を揃えます。
入力を直さずに再送し続けない
入力条件が変わらないまま同じ要求を繰り返しても、問題が解消するとは限りません。何を直す必要があるかを確認し、元の操作がどこまで処理されたかもAPIの契約に従って判断します。
認証情報の不足や権限による拒否は別の観点です。401と403の違いも併せて整理すると、入力検証と認証を混同せずに済みます。
番号と修正手掛かりを対応させる
失敗した検証段階・利用者が直す項目・再実行条件を一組で決めましょう。応答仕様はAPI設計書へ残し、APIと利用側で同じ意味になるように確認します。