Entregas
Cada vez que o Dashboard Mágico manda um evento para um endpoint, ele registra uma entrega: o que foi enviado, o que o seu sistema respondeu e quantas tentativas foram feitas. Com isso você descobre por que um aviso não chegou e reenvia o que falhou.
Onde ver
Na aba Webhooks de Sistema › API (/dashboard/api?tab=webhooks):
- o cartão Logs de Entrega, embaixo da lista de endpoints, mostra as entregas de todos os endpoints do workspace;
- o número na coluna Entregas de um endpoint abre só as entregas dele.
Nos Logs de Entrega, filtre por Data, Status e Webhook, e use o botão de atualizar para buscar as entregas mais recentes. Cada linha mostra:
| Coluna | O que é |
|---|---|
| Data | Quando a entrega foi criada. |
| Webhook | A URL do endpoint. |
| Evento | O tipo do evento, como api_key.revoked. |
| Status | Em que pé a entrega está (veja abaixo). |
| HTTP | O código que o seu sistema respondeu, em verde quando é 2xx. |
| Tentativas | Quantas vezes o envio foi tentado. |
Status
| Status | O que significa |
|---|---|
| Pendente | Na fila, ainda não enviada. |
| Entregue | O seu sistema respondeu com um código 2xx em até 30 segundos. |
| Falhou | O seu sistema respondeu com outro código, demorou mais de 30 segundos ou não pôde ser alcançado. |
Ver os detalhes de uma entrega
Clique no ícone de olho da linha para abrir os detalhes:
- o status, o código HTTP e a mensagem de erro, quando houve;
- os headers e o corpo da requisição que o Dashboard Mágico enviou — as credenciais de autenticação aparecem mascaradas;
- os headers e o corpo da resposta do seu sistema (até 10.000 caracteres).
Se a requisição nem chegou ao destino (endereço fora do ar, tempo esgotado), a resposta aparece como Sem resposta.
Novas tentativas
Quando uma entrega falha, o Dashboard Mágico tenta de novo sozinho, com um intervalo que dobra a cada tentativa. Cada tentativa conta para a desativação automática: depois de 10 falhas seguidas, o endpoint é desligado (veja Webhooks).
Para reenviar uma entrega que terminou como Falhou, clique no botão de reenviar da linha (Retentar). A entrega volta para a fila e é enviada de novo, com os mesmos dados.
:::tip O mesmo evento pode chegar mais de uma vez
Por causa das novas tentativas e do reenvio manual, o seu sistema pode receber o mesmo evento duas vezes. Use o header X-Kobana-Event-Id para processar cada evento uma vez só.
:::