Skip to main content

HTTP ステータスコード

API は標準的な HTTP ステータスコードを使用します。以下はよく使われるステータスコードとその意味です。

エラーレスポンス形式

エラーが発生した場合、API は以下の形式の JSON レスポンスを返します。

レスポンスフィールド

一般的なエラー

認証エラー (401)

原因: API キーが無効または不足している

権限エラー (403)

原因: リクエストされた操作に対する権限がない

検証エラー (422)

原因: リクエストパラメータがバリデーションルールを満たしていない

エラー処理のベストプラクティス

  1. すべての HTTP ステータスコードを適切に処理する
  2. 特に 429 (レート制限) エラーに対しては、リトライロジックを実装する
  3. エラーメッセージをログに記録して、問題の診断に役立てる
  4. ユーザーにわかりやすいエラーメッセージを表示する
  5. センシティブな情報をエラーメッセージへ含めないようにする
最終更新日 2026年6月24日