Erros
Formato padrão:
{ "error": "mensagem descritiva" }| Status | Significado |
|---|---|
402 | Conta com pagamento pendente — resolve no dashboard |
403 | API Key ausente, inválida ou revogada |
404 | Recurso não encontrado (ex.: requestId inexistente) |
409 | Conflito |
422 | Dados do pedido inválidos — ver detalhes |
429 | Limite de pedidos excedido — ver Limites de Uso |
500 | Erro interno — tenta novamente; se persistir, contacta o suporte |
Erro de validação (422)
{
"error": "Dados inválidos no pedido.",
"detalhes": [
{ "campo": "documents → 0 → lines → 0 → creditAmount", "mensagem": "...", "tipo": "missing" }
]
}detalhes pode conter mais de um campo — percorre a lista toda antes de corrigir e reenviar.
Caso especial: fila indisponível (503)
⚠️
Em raras ocasiões de sobrecarga, a resposta usa detail em vez de error.
{ "detail": "Serviço temporariamente indisponível. Tente novamente em instantes.", "requestId": "uuid" }Trata este caso à parte no teu tratamento de erros e tenta novamente com um pequeno atraso.