API 總覽

Base URL

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

身分驗證

所有端點使用 HTTP Bearer（API Key）：

Authorization: Bearer YOUR_API_KEY

請從 Thunderbit 主控台 取得你的 Key。Key 可撤銷、依環境區分 —— 切勿將正式 Key 嵌入用戶端程式碼。

錯誤回應結構

所有錯誤回應共用同一種 envelope。預設採用 LEGACY 格式：

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

Note: 先前文件曾介紹 GOOGLE_RPC 備選 envelope，code 與 status 型別互換（string ↔ number）。該模式 已棄用，不推薦使用 —— 強型別客戶端（OpenAPI codegen、Pydantic、serde、encoding/json）會直接反序列化失敗。請使用上面的 LEGACY 格式；未來 code: string、status: number 型別保持穩定。

details 欄位可能攜帶結構化內容 —— 例如 INVALID_PARAMETER 錯誤時會回傳欄位級驗證錯誤，格式為 { field: message }。

標準錯誤碼

重試策略參考