Troubleshooting
Diagnóstico rápido antes de abrir suporte.
Atualizado em 01/09/2026
| Sintoma | Verifique primeiro |
|---|---|
| 401 | Ambiente do token, expiração, credencial/instalação revogada e Bearer header |
| 403 INSUFFICIENT_SCOPE | Scopes concedidos à instalação e novo token após alteração |
| 403 IP_NOT_ALLOWED | IP de egress real e CIDR cadastrado |
| Lista vazia | Ambiente, Location/Service filters e disponibilidade/publicação do recurso |
| 409 SLOT_UNAVAILABLE | Nova consulta de availability e concorrência |
| Webhook inválido | Raw body, whsec_, timestamp, múltiplas v1 signatures e comparação constante |
| Webhook duplicado | Deduplique pelo webhook-id |
| 429/503 | Retry-After, backoff e custo ponderado da operação |
Ao investigar uma falha, registre método/path, ambiente, horário UTC, HTTP status, code, requestId e a Idempotency-Key quando aplicável. Envie o contexto para suporte@hubday.com.br. Nunca envie client_secret, access token, signing secret ou dados sensíveis em ticket/log de suporte.