Panoramica API

URL base

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

Autenticazione

Tutti gli endpoint usano HTTP Bearer (API Key):

Authorization: Bearer YOUR_API_KEY

Ottieni la tua chiave dalla Dashboard Thunderbit. Le chiavi sono revocabili e per ambiente — non incorporare mai una chiave di produzione nel codice client-side.

Struttura degli errori

Tutte le risposte di errore condividono la stessa envelope. Per impostazione predefinita (formato LEGACY):

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

Note: In precedenza era documentata una busta alternativa GOOGLE_RPC in cui code e status invertivano i tipi (string ↔ number). È deprecata e sconsigliata — i client tipizzati (OpenAPI codegen, Pydantic, serde, encoding/json) falliranno la deserializzazione. Usa il formato LEGACY sopra; gli aggiornamenti futuri manterranno code: string e status: number stabili. Il campo details può contenere contesto strutturato — ad esempio, errori di validazione a livello di campo come coppie { field: message } restituite con INVALID_PARAMETER.

Codici di errore canonici

Riferimento strategia di retry