Erros HTTP e diagnostico de integracoes
Use este guia para investigar falhas comuns sem depender de acesso interno da Digi2B.
Codigos comuns
| Codigo | Significado | Verifique |
|---|---|---|
| 200/201 | Sucesso | Processar resposta e guardar IDs |
| 400 | Requisicao invalida | JSON, query params e tipos |
| 401 | Nao autenticado | Header api_access_token e token correto |
| 403 | Sem permissao | Papel do usuario e recurso habilitado |
| 404 | Nao encontrado | Conta, ID, ambiente e rota |
| 422 | Validacao falhou | Campos obrigatorios, enums e regras do canal |
| 429 | Muitas requisicoes | Reduzir volume e aplicar retry com espera |
| 500 | Erro interno | Registrar evidencias e acionar suporte |
Evidencias para suporte
Envie:
- metodo e endpoint;
- horario com fuso;
- status HTTP;
x-request-id, se houver;- payload sem dados sensiveis;
- resposta de erro;
- objetivo da integracao.
Dica
Quando houver divergencia de formato, compare com uma acao equivalente feita pelo painel da IAra usando a aba Network do navegador.