Aperçu de l'API

URL de base

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

Authentification

Tous les endpoints utilisent HTTP Bearer (API Key) :

Authorization: Bearer YOUR_API_KEY

Récupère ta clé depuis le Dashboard Thunderbit. Les clés sont révocables et propres à chaque environnement — n'intègre jamais une clé de production dans du code côté client.

Enveloppe d'erreur

Toutes les réponses d'erreur partagent la même enveloppe. Par défaut (format LEGACY) :

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

Note: Une enveloppe alternative GOOGLE_RPC était auparavant documentée, où code et status permutaient leurs types (string ↔ number). Elle est dépréciée et non recommandée — les clients fortement typés (OpenAPI codegen, Pydantic, serde, encoding/json) échoueront à désérialiser. Utilisez le format LEGACY ci-dessus ; les futures mises à jour conserveront code: string et status: number stables. Le champ details peut transporter un contexte structuré — par exemple, des erreurs de validation au niveau des champs sous forme de paires { field: message } renvoyées avec INVALID_PARAMETER.

Codes d'erreur canoniques

Référence de stratégie de réessai