HTTP ステータス コード

HTTP レスポンスで返されるステータス コードは以下のとおりです。

HTTP コード HTTP の説明 メモ
2xx OK エラーではありません。成功したときに返されます。これは、ビジネス ロジックの障害にも使用する必要があります（例: CreateBookingResponse の booking_failure が入力されている）。
400 不正なリクエスト 不正なリクエスト/無効な引数（販売者、サービス、スロットが見つからない、無効なスロットを予約しようとした、存在しない予約をキャンセルしている）。
401 非許可 未認証（無効な認証情報、ログインの再試行）。リクエストには、オペレーションのための有効な認証情報がありません。
403 禁止動作 アクセスが拒否されたか、禁止されています（呼び出し元は既知であり、拒否されています）。このレスポンスは、リソースの枯渇を原因とする拒否には使用できません（このようなエラーには Too Many Requests を使用します）。呼び出し元が特定できない場合は、Forbidden を使用しないでください（このようなエラーには代わりに Unauthorized を使用します）。
404 未検出 未検出（リソースが見つからない、無効な URL（無効な RPC など））
409 対立 オペレーションは、通常、シーケンサー チェックの失敗、またはトランザクションの中止などの同時実行の問題のために中止されています。
429 リクエストが多すぎます ユーザーごとの割り当て、またはファイル システム全体で容量が不足しているため、一部のリソースが枯渇しています。
499 クライアントによるリクエストの終了 オペレーションがキャンセルされました。通常、キャンセルは呼び出し元によって行われます。
500 内部サーバーエラー 内部エラー。これは、基盤となるシステムで予期される一部の不変条件が満たされていないことを意味します。このエラーコードは深刻なエラーのために予約されています。
501 実装されていません オペレーションが実装されていないか、このサービスでサポートまたは有効にされていません。
503 サービスを利用できません サービスは現在使用できません。これは、バックオフで再試行することで解決できる可能性が高い一時的な状態です。
504 ゲートウェイのタイムアウト オペレーションが完了する前に期限が切れました。システムの状態を変更するオペレーションの場合、オペレーションが正常に終了しても、このエラーが返されることがあります。たとえば、サーバーからの正常なレスポンスが期限切れになるほど遅延する場合もあります。

複数のエラーコードが該当する場合があります。サービスは、該当する最も具体的なエラーコードを返す必要があります。