# Erros e códigos HTTP

Como interpretar falhas e decidir quando repetir uma chamada.

## Códigos HTTP

HTTPSignificadoAção

400Dados inválidosCorrija os campos antes de reenviar.

401Chave inválidaConfira o header X-API-Key e a situação da credencial.

403Acesso bloqueadoRevise escopo, permissões, IPs e bloqueios da conta.

404Recurso não encontradoConfira o ID e a carteira à qual ele pertence.

409ConflitoNão reutilize uma chave de idempotência com outro corpo.

422Regra da operaçãoConfira saldo disponível, limites e dados obrigatórios.

429Limite de chamadasAguarde antes de continuar.

503Provedor indisponívelConsulte a operação antes de repetir uma escrita.

## Repetição segura

Para a mesma operação, repita a mesma chave e os mesmos dados. Uma resposta em processamento não autoriza criar outra operação com uma chave diferente.

## Exemplo de erro

```
{
  "success": false,
  "message": "Saldo disponível insuficiente.",
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "statusCode": 422
  },
  "requestId": "req_exemplo"
}
```
