Resumen de la API

URL base

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

Autenticación

Todos los endpoints usan HTTP Bearer (API Key):

Authorization: Bearer YOUR_API_KEY

Obtén tu key desde el Panel de Thunderbit. Las keys son revocables y por entorno — nunca incrustes una key de producción en código del cliente.

Estructura del error

Todas las respuestas de error comparten la misma envoltura. Por defecto (formato LEGACY):

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

Note: Anteriormente se documentaba un envelope alternativo GOOGLE_RPC donde code y status intercambiaban tipos (string ↔ number). Está obsoleto y no se recomienda — los clientes con tipado estricto (OpenAPI codegen, Pydantic, serde, encoding/json) fallarán al deserializar. Usa el formato LEGACY anterior; las actualizaciones futuras mantendrán code: string y status: number estables. El campo details puede llevar contexto estructurado — por ejemplo, errores de validación a nivel de campo como pares { field: message } que se devuelven en INVALID_PARAMETER.

Códigos de error canónicos

Referencia de estrategia de reintentos