Entrega e reenvio
O que acontece quando o seu servidor não responde, quando o mesmo aviso chega duas vezes e como reenviar um aviso pelo painel.
O que conta como entregue
Um aviso só está entregue se o seu servidor responder com status 2xx em até 5 segundos. Qualquer outra coisa (4xx, 5xx, demora, erro de conexão, certificado inválido) conta como falha e o aviso entra na fila de novas tentativas. Lemos no máximo 64 KB da resposta e guardamos só o começo dela, para você ver no painel.
Novas tentativas
São até 8 tentativas no total: a primeira e mais 7. Entre uma e outra a espera cresce:
| Tentativa | Quando acontece |
|---|---|
| 1ª | Logo depois do evento |
| 2ª | cerca de 1 minuto depois da 1ª |
| 3ª | cerca de 5 minutos depois da 2ª |
| 4ª | cerca de 15 minutos depois da 3ª |
| 5ª | cerca de 1 hora depois da 4ª |
| 6ª | cerca de 3 horas depois da 5ª |
| 7ª | cerca de 6 horas depois da 6ª |
| 8ª (última) | cerca de 12 horas depois da 7ª |
Os horários são aproximados (a fila roda em ciclos curtos). Depois da 8ª falha o envio fica como falhou e não tenta mais sozinho.
Com todas as tentativas, o seu servidor tem cerca de 22 horas para voltar. Passou disso, use o reenvio do painel e a conciliação para recuperar o que perdeu.
Repetição e ordem
- O mesmo aviso pode chegar mais de uma vez (a sua resposta se perdeu no caminho, por exemplo). O
iddo evento é sempre o mesmo: guarde os já tratados. - Os avisos podem chegar fora de ordem. Um
venda.expiradaque falhou e foi reenviado pode chegar depois dovenda.aprovadada mesma cobrança. Use asequencia: ignore o evento com sequência menor que a última que você tratou daquele recurso. - O conteúdo de
dadosé o do momento do evento, também nas novas tentativas. Para saber como a cobrança está agora, consulte GET /charges/{id}.
idtextoMesmo valor em todas as tentativas do mesmo evento: é a chave da sua idempotência.
sequenciainteiroOrdem em que os eventos aconteceram na conta. Evento mais novo tem número maior.
X-Grinny-EventcabeçalhoO tipo do evento, para você roteirizar antes de ler o corpo.
X-Grinny-SignaturecabeçalhoHorário e assinatura. A assinatura é nova a cada tentativa (muda o t): confira sempre a que veio no pedido.
Reenviar pelo painel
- Em Integrações › Webhooks você vê os envios, o código que o seu servidor respondeu e o começo da resposta.
- O botão de reenvio põe o aviso de volta na fila, com a contagem de tentativas zerada.
- Existe um limite de reenvios seguidos por conta (para ninguém derrubar o próprio servidor por engano).
- Webhook pausado não recebe nada: os avisos esperam e saem quando você ativa de novo.
- Webhook excluído para na hora e as entregas pendentes dele são descartadas.
Por quanto tempo guardamos
O conteúdo dos avisos enviados (que inclui o nome e o e-mail do comprador) fica guardado por tempo limitado e depois é apagado. O histórico de que o envio aconteceu continua. Por isso, não conte com o painel como arquivo: grave o que importa no seu sistema.