どのような HTTP ステータスコードが返されますか?
すべてのエラーには、HTTP ステータスと変わることのないエラーコードが含まれます。分岐はメッセージではなくコードで行ってください。
各エラーレスポンスには、エラーコードと、人が読むためのメッセージが含まれます。コードは次のとおりです。
- 400 invalid_parameter: パラメーターが不明、形式が不正、または範囲外です
- 400 invalid_cursor: カーソルの形式が不正、有効期限切れ、または別のキーや別のフィルターに対して発行されたものです
- 401 unauthenticated: キーが送られていない、認識できない、または無効化されています
- 403 ip_not_allowed、key_paused、country_not_entitled、upgrade_required: リクエストが許可されていません。理由ごとの対処方法は「403 エラーが返されるのはなぜですか?」をご覧ください
- 404 not_found: パスが存在しません
- 405 method_not_allowed: エンドポイントはすべて GET です
- 429 rate_limited または quota_exceeded: Retry-After の期間が過ぎるまで待ってください
- 500 internal_error: 時間をおいて再試行してください
- 503 not_configured または service_unavailable: 時間をおいて再試行してください
新しいコードが追加されることがあります。認識できないコードは、一緒に返された HTTP ステータスの失敗として扱ってください。