Erros

Formato único de erro.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Saldo de créditos insuficiente.",
    "correlationId": "4f1c9a7e-…"
  }
}

Use code na sua lógica e informe correlationId ao suporte. Mensagens podem mudar; códigos, não.

Códigos comuns

• validation_error (422): corpo inválido; veja details.
• invalid_api_key (401) e insufficient_scope (403).
• product_not_activated (403): ative o produto no Marketplace.
• insufficient_credits e budget_exceeded (402).
• no_eligible_provider (503): nenhum provedor habilitado neste ambiente.
• provider_failure (502): o provedor falhou e nada foi cobrado.
• rate_limited (429): respeite o cabeçalho Retry-After.
• idempotency_mismatch (422): chave reutilizada com outro corpo.