Consulta de CPF e CNPJ
O corpo do erro é sempre o mesmo objeto, e o que você deve tratar é ocodigo. Ele é uma
string estável nossa, não o número que o bureau devolveu, justamente para o seu if
continuar valendo se o fornecedor mudar.
Os erros de
400 e 403 não custam nada: eles acontecem antes de qualquer chamada paga.
O nao_encontrado e o consulta_indisponivel podem ter custado, porque quem respondeu
foi o bureau.
Entrada de contatos
Aqui o corpo traz um campoerror com texto em inglês, porque é lido por máquina.
Como tratar do seu lado
400 é definitivo, não tente de novo
400 é definitivo, não tente de novo
Problema de dado ou de configuração. Repetir a mesma requisição devolve o mesmo erro.
Registre e siga.
401 e 403 pedem intervenção humana
401 e 403 pedem intervenção humana
Credencial trocada, chave sem escopo, webhook desligado. Alerte quem cuida da
integração em vez de tentar de novo em laço.
429 diz quando voltar
429 diz quando voltar
Respeite o
Retry-After quando ele vier. Quando não vier, o caso é teto mensal, e
esperar não resolve: alguém precisa aumentar o teto.500 e 502 valem tentativa
500 e 502 valem tentativa
Falha temporária. Uma ou duas tentativas com espera crescente resolvem a maioria dos
casos. Não repita indefinidamente.
Sucesso duplicado
A entrada de contatos não é idempotente: duas requisições iguais criam dois contatos. A consulta é diferente, porque o cache de 30 dias faz a segunda chamada do mesmo documento voltar sem custo, comcache: true.