API-Übersicht

Basis-URL

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

Authentifizierung

Alle Endpunkte verwenden HTTP Bearer (API Key):

Authorization: Bearer YOUR_API_KEY

Hol dir deinen Key im Thunderbit Dashboard. Keys sind widerrufbar und pro Umgebung getrennt — bette niemals einen Produktions-Key in Client-Code ein.

Fehler-Envelope

Alle Fehlerantworten teilen sich denselben Envelope. Standardmäßig (LEGACY-Format):

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

Note: Zuvor wurde ein alternatives GOOGLE_RPC-Envelope dokumentiert, bei dem code und status ihre Typen tauschten (string ↔ number). Es ist veraltet und nicht empfohlen — stark typisierte Clients (OpenAPI codegen, Pydantic, serde, encoding/json) scheitern beim Deserialisieren. Nutzen Sie das LEGACY-Format oben; künftige Updates halten code: string und status: number stabil. Das Feld details kann strukturierten Kontext enthalten — zum Beispiel feldbezogene Validierungsfehler als { field: message }-Paare bei INVALID_PARAMETER.

Kanonische Fehlercodes

Wiederholungsstrategie