Tentativas, desativação e reenvio

Cada endpoint recebe a sua própria entrega de cada evento. Uma entrega passa por estes status, que aparecem na coluna Status de Entregas recentes:

O que conta como falha está em A resposta.

Calendário de tentativasCopiar link da seção

São até 8 tentativas por entrega. A primeira sai logo depois de o evento ser criado, em geral em menos de um minuto. Depois de cada falha, o Vipter espera:

As esperas são mínimas: a fila é processada a cada minuto, então cada tentativa pode sair um pouco depois. Se a oitava falhar, a entrega fica exhausted. Na prática, um endpoint que volta ao ar até cerca de 3 dias e 8 horas depois de uma falha ainda recebe o evento sozinho.

Cada tentativa leva o mesmo corpo, com o mesmo id e o mesmo created, e uma assinatura nova, com o t do momento do envio.

Desativação automáticaCopiar link da seção

O Vipter conta, por endpoint, as entregas seguidas que terminaram em exhausted. Quando a contagem chega a 20, o endpoint é desativado e o card dele mostra o motivo auto-disabled after 20 exhausted deliveries. Uma entrega com succeeded zera a contagem.

A contagem é de entregas esgotadas, não de tentativas: são 20 eventos que falharam 8 vezes cada. Um endpoint fora do ar só é desativado depois de passar pelo calendário inteiro de pelo menos 20 eventos.

Para ligar de novo, corrija o seu servidor e ative a chave Ativo do endpoint. Ligar a chave zera a contagem e apaga o motivo.

Eventos enquanto o endpoint está desativadoCopiar link da seção

Vale tanto para a desativação automática quanto para a chave desligada à mão:

• Eventos novos não são guardados para ele. O endpoint só recebe entregas dos eventos criados enquanto está ativo. Um evento criado durante a desativação nunca chega a esse endpoint, nem depois de ligar de novo, e não há como reenviá-lo.
• Entregas que já estavam na fila são encerradas. Na vez delas, ficam exhausted com o erro endpoint disabled, sem tentar enviar e sem contar para a desativação. Ligar o endpoint de novo não as retoma: use Reenviar em cada uma, com o endpoint já ativo.

O mesmo vale para um endpoint criado depois de um evento: ele não recebe eventos anteriores à sua criação.

Para conferir o que aconteceu no período, compare o seu sistema com as listas de pedidos, assinaturas e clientes do painel.

Reenviar uma entregaCopiar link da seção

Entregas recentes mostra as 50 entregas mais recentes da loja, de todos os endpoints. Toda linha que não está succeeded tem o botão Reenviar. Ao clicar:

1. A entrega volta para pending com as tentativas zeradas e é enviada na hora.
2. Aparece Entrega reenfileirada..
3. Se falhar de novo, ela segue o calendário desde o início.

O reenvio manda o mesmo evento, com o mesmo id: o seu controle de idempotência trata como repetição se ele já tiver sido processado. A assinatura é calculada no momento do reenvio, com o segredo atual.

Não dá para reenviar uma entrega succeeded pelo painel. Reenviar para um endpoint desativado encerra a entrega na hora com endpoint disabled: ligue o endpoint antes.

Evento de testeCopiar link da seção

O botão Enviar evento de teste cria um evento customer.created novo, com um cliente fictício e "test": true em data.object. O formato está no catálogo.

• Ele vai para todos os endpoints ativos que recebem customer.created ou todos os eventos, e só para esses.
• É enviado na hora e aparece Evento de teste enfileirado.. Se falhar, segue o mesmo calendário de tentativas de um evento real e conta para a desativação automática.
• Cada clique cria um evento com um id novo.
• Sem nenhum endpoint ativo, o botão fica desabilitado.

Remover um endpointCopiar link da seção

Remover apaga o endpoint, o segredo e o histórico de entregas dele. As entregas pendentes param. Para trocar de URL sem perder eventos, crie o endpoint novo, confirme que ele recebe o evento de teste e só então remova o antigo. Nesse intervalo, os dois recebem os mesmos eventos, com o mesmo id.

O que fazer a seguirCopiar link da seção

• Veja como responder rápido para não gerar tentativas à toa.
• Troque o segredo sem perder eventos em Verificar a assinatura.