# 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.