Visão Geral da API

URL base

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

Autenticação

Todos os endpoints usam HTTP Bearer (API Key):

Authorization: Bearer YOUR_API_KEY

Pegue sua chave no Painel Thunderbit. As chaves são revogáveis e por ambiente — nunca embuta uma chave de produção em código do lado do cliente.

Estrutura de erro

Todas as respostas de erro compartilham o mesmo envelope. Por padrão (formato LEGACY):

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

Note: Anteriormente era documentado um envelope alternativo GOOGLE_RPC em que code e status trocavam de tipos (string ↔ number). Está descontinuado e não recomendado — clientes com tipagem forte (OpenAPI codegen, Pydantic, serde, encoding/json) falharão na desserialização. Use o formato LEGACY acima; futuras atualizações manterão code: string e status: number estáveis. O campo details pode trazer contexto estruturado — por exemplo, erros de validação por campo como pares { field: message } retornados em INVALID_PARAMETER.

Códigos de erro canônicos

Referência de estratégia de retry