Códigos de erro
Todos os códigos negativos e estados HTTP do catálogo de erros do CPI, o que significam e o que fazer.
A Xuda mantém um único catálogo de todos os erros com que uma chamada pode regressar. Esta página é esse catálogo, organizado pelo local onde o erro aparece. Consulte Erros para ver o enquadramento específico da API dos mesmos códigos.
Erros de estado HTTP
Estes são os estados que vê na camada de transporte, quer aceda diretamente a uma página quer a uma
chamada cpi.
Códigos de contrato do cliente
O próprio cliente do painel reconhece estes códigos e inicia com eles um fluxo de interface
específico em vez de uma mensagem de erro genérica. A faturação passou de um saldo pré-pago para
faturas pós-pagas, por isso os únicos bloqueios que restam numa ação paga são a falta de um cartão e
uma fatura em atraso. Os códigos -92 (saldo negativo) e -93 (carregamento necessário) já não
existem no bloqueio da conta que os lançava; ainda há um tratador de -93 no cliente por
compatibilidade, mas já nada o aciona.
O envelope da resposta
Todos os métodos, com sucesso ou falha, respondem { code, data }. code >= 1 é sucesso; code < 0
é um erro. Alguns erros da camada HTTP acrescentam uma chave error em texto junto do code
numérico ("rate_limited", "invalid_fields", "appeal_failed"), por vezes com um array
fields: [].
O CPI mapeia um code negativo para um estado HTTP com uma só regra: um código de -400 a -499
torna-se exatamente esse estado (-400 responde HTTP 400, -404 responde HTTP 404, -409 responde
HTTP 409, -428 responde HTTP 428). Todos os outros códigos negativos, -1, -500, -762, -999,
qualquer um fora dessa faixa, respondem também com um HTTP 400 simples. Alguns endpoints separados e
mais restritos (algumas rotas de checkout da loja e de formulários públicos, não o despacho geral
/cpi/<method>) mapeiam apenas -404/-403/-400 e por omissão enviam tudo o resto para 422; esse
mapa é local a essas rotas e não descreve a regra geral acima, por isso um -400 do despacho geral é
HTTP 400, não 422.
O mesmo número é reutilizado em métodos diferentes com significados diferentes, sobretudo -1 e
-400. Leia sempre a mensagem de data e o método que chamou; os significados abaixo são o caso
comum, não uma garantia.
Códigos negativos do CPI
Os códigos em que vale a pena ramificar, reunidos a partir de uma análise de todos os cpi/*_module.
Para além desta tabela, os módulos individuais usam pequenos códigos negativos (aproximadamente de
-2 a -25, -44/-45/-46, -64 a -78, -99/-101/-106) para estados intermédios
específicos do módulo. Quase sempre vêm acompanhados de uma mensagem descritiva em data, muitas
vezes err.message. Quando encontrar um, leia o texto de data e o método de origem em vez de
confiar apenas no número.
Erros internos / não declarados
Algumas falhas nunca chegam ao envelope { code, data }: uma exceção não capturada, uma rejeição de
promessa não tratada, um throw new Error(...) que surge como um 401 ou 500 simples (por exemplo
'app is off', 'Account suspended', 'Account terminated'), ou uma falha do message broker. São
detetadas pela forma ou pela origem e não por um código fixo, e vale sempre a pena escalá-las em vez
de tentar de novo às cegas.