Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Webhooks/Entregas do webhook

Entregas do webhook

GET /v1/webhooks/:id/deliveries escopo admin

Entregas recentes, da mais nova para a mais antiga (limit de 1 a 100, padrão 20; guardadas por 30 dias): evento, estado (pending, delivered, failed, discarded), tentativas, último status HTTP e erro, duração.

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Parâmetros

Nome Onde Descrição
id caminho Id do webhook (começa com wh_).
limit consulta Quantas entregas (1 a 100). Padrão: 20.

Exemplo

curl "https://praeko.app/v1/webhooks/wh_01KA3X4D8P6TQ1VZ0C7MH2NB5R/deliveries" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "deliveries": [
    {
      "id": "whd_01KA3X9F2Z4WJ8G6D1RT5YQK3C",
      "event": "post.sent",
      "eventId": "evt_01KA3XB7W3N8QZ5RD2VH6TM9KF",
      "state": "delivered",
      "attempts": 1,
      "lastStatus": 200,
      "durationMs": 142,
      "createdAt": "2026-11-07T14:02:11.482Z",
      "deliveredAt": "2026-11-07T14:02:11.482Z"
    }
  ]
}

Erros

Status code Quando
404 webhook_not_found O webhook não existe.
422 invalid_field limit fora de 1 a 100.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.