API-overzicht

Basis-URL

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

Authenticatie

Alle endpoints gebruiken HTTP Bearer (API Key):

Authorization: Bearer YOUR_API_KEY

Haal je key op vanuit het Thunderbit Dashboard. Keys zijn intrekbaar en per omgeving — sluit nooit een productiekey in clientcode in.

Foutomhulsel

Alle foutresponses delen dezelfde envelope. Standaard (LEGACY-formaat):

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

Note: Er was eerder een alternatieve GOOGLE_RPC-envelope gedocumenteerd waarbij code en status van type wisselden (string ↔ number). Deze modus is verouderd en niet aanbevolen — sterk getypeerde clients (OpenAPI codegen, Pydantic, serde, encoding/json) zullen niet kunnen deserialiseren. Gebruik het bovenstaande LEGACY-formaat; toekomstige updates houden code: string en status: number stabiel. Het veld details kan gestructureerde context bevatten — bijvoorbeeld validatiefouten op veldniveau als { field: message }-paren die bij INVALID_PARAMETER worden teruggegeven.

Canonieke foutcodes

Retry-strategie referentie