HTTP 400と422の違い|入力エラーを分類する考え方

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と利用側で同じ意味になるように確認します。

記事一覧へ戻る

ITの困りごとを、
まずはご相談ください。

何から手をつけるか決まっていない段階でも構いません。ご相談内容に応じて、担当者からご連絡します。

まずは相談する

採用へのご応募は採用エントリーからお願いします。