400 Bad Requestバリデーションエラーのモック

400 Bad Request — バリデーションエラー

400ステータスコードは、クライアント側の入力エラーによりサーバーがリクエストを処理できないことを示します。このモックはRFC 7807「Problem Details」パターンをJSON APIに適応した構造化バリデーションエラーレスポンスを生成します。

レスポンス構造

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request body is invalid or missing required fields.",
    "details": [
      {
        "field": "email",
        "message": "Must be a valid email address."
      },
      {
        "field": "name",
        "message": "Must be at least 2 characters long."
      }
    ]
  }
}

設計原則

• 機械可読コード — codeフィールドはクライアントがswitch文やエラーマッピングロジックで使用できる安定した識別子を提供します。
• 人間可読メッセージ — messageフィールドはエンドユーザーへの表示やログ記録に適した一般的な説明を提供します。
• フィールドレベル詳細 — details配列は各バリデーションエラーを特定のフィールドにマッピングし、インラインフォームバリデーションフィードバックを可能にします。

フロントエンドでの処理

400レスポンスを受信した場合、フロントエンドは：

1. details配列を解析する
2. 各エントリを対応するフォームフィールドにマッピングする
3. 入力の横にエラーメッセージを表示する
4. オプションでトップレベルのmessageをトーストまたはバナーとして表示する

一般的なバリエーション

一部のAPIはdetailsの代わりにerrorsを使用したり、構造を異なるネストにしたりします。重要な原則は一貫性です：1つのフォーマットを選び、すべてのエンドポイントで使用してください。