Resumo: as mensagens desta página foram extraídas do código dos serviços e, quando marcadas como verificadas, de chamadas reais à API. Elas vêm em português e são o texto exato que chega no campo
message.Formato
Autenticação
Repare na assimetria: client id errado dá 400, secret errado dá 401. Se você trata só 401 como “credencial inválida”, o caso do id errado escapa.
Permissão
Relatório
Exportação
As rotas de exportação respondem
202 Accepted, não 200. Ver Exportar Relatório.Política de crédito
Comitê de Crédito IA
Detalhes do padrão de retry em Convocar Comitê.
Webhook
Autorização de SCR (opt-in)
Erros de servidor
Boas práticas
Trate pelo código, não pela mensagem
Trate pelo código, não pela mensagem
As mensagens são texto de UI e mudam. Erros de validação concatenam várias falhas numa string só, então match exato quebra fácil.
Separe transitório de definitivo
Separe transitório de definitivo
400 de “ainda não finalizou” pede retry com backoff; 400 de “não habilitado” não muda com o tempo. A tabela do comitê marca isso na coluna Repetir.404 nem sempre é 'não existe'
404 nem sempre é 'não existe'
Relatório de outra organização também devolve
404, de propósito, para não vazar a existência de dados de terceiros. Se você tem certeza de que o ID existe, confira o token usado.Erro de seção não derruba o relatório
Erro de seção não derruba o relatório
Uma fonte que falha registra o problema em
errors daquela seção e o relatório segue. Verifique esse campo antes de assumir que o dado simplesmente não existe.