API 概要

Base URL

https://openapi.thunderbit.com/openapi/v1

認証

すべてのエンドポイントで HTTP Bearer（API Key）を使用します：

Authorization: Bearer YOUR_API_KEY

Thunderbit ダッシュボード からキーを取得してください。キーは取り消し可能で環境ごとに分離されています —— 本番キーをクライアント側コードに埋め込まないでください。

エラーレスポンスの形式

すべてのエラーレスポンスは同じエンベロープを共有します。デフォルトは LEGACY 形式：

{
  "success": false,
  "error": {
    "code":    "INVALID_URL",
    "status":  400,
    "message": "The provided URL is not valid",
    "details": null
  }
}

Note: 以前 GOOGLE_RPC 代替エンベロープが記載されており、code と status の型が入れ替わっていました（string ↔ number）。このモードは 非推奨 です — 厳格型のクライアント（OpenAPI codegen、Pydantic、serde、encoding/json）は逆シリアライズに失敗します。上記の LEGACY 形式を使ってください。将来も code: string、status: number を維持します。 details フィールドには構造化されたコンテキストが含まれることがあります —— 例えば INVALID_PARAMETER では { field: message } 形式のフィールド単位の検証エラーが返されます。

標準エラーコード

リトライ戦略リファレンス