Respostas que exigem atenção
| HTTP | Verifique | Ação |
|---|---|---|
| 400 | Campos, tipos e UUID v4. | Corrija o corpo; não repita a mesma requisição inválida. |
| 401 | Segredo, headers, assinatura, relógio e corpo exato. | Corrija autenticação e sincronize o relógio. |
| 403 | DLQ_INGESTION_BLOCKED_LIMIT | Respeite a política de franquia e as instruções de buffer/descarte. |
| 409 | eventId reutilizado com conteúdo diferente. | Reenvie o corpo original; use novo ID somente para nova captura. |
| 413 | Limite do servidor ou proxy. | Reduza o payload; criptografia hexadecimal aumenta o tamanho. |
| 408 / 425 / 429 / 5xx | Falha temporária ou velocidade excessiva. | Reenvie com espera e limites, preservando ID e corpo. |
Não encontrei o evento
Confirme o ambiente Cloud/Self-hosted, o projeto associado ao segredo, os filtros de data, o fuso e o fingerprint. Um evento já existente pode ter recebido uma nova ocorrência em vez de criar uma nova linha. No SDK, enfileirar não é confirmar entrega: observe onDelivery e o resultado de close.
Ao investigar
Guarde status HTTP, horário, versão do SDK/API e eventId para rastrear a captura. Não inclua segredo, headers de autenticação nem payloads sensíveis em prints ou solicitações de suporte.