Referência da API
Métricas agregadas
Agrega contadores de entrega pros últimos 24h e 7d. Útil pra dashboards de saúde da integração (success rate, latência média). **Rate limit:** 10 chamadas / minuto por API key (HTTP 429 se exceder). **Cache server-side de 60s** — chamadas dentro dessa janela retornam a mesma resposta sem hit no backend. Se você precisa de granularidade menor, use `/deliveries` e agregue você mesmo.
GET
/v2/webhooks/:id/metricsAutenticação
HTTP Basic Auth. Envie sua secret key no header:
Authorization: Basic {base64(secret:SUA_SECRET_KEY)}Parâmetros
idstring (path)obrigatórioUUID do webhook.
Exemplo: wh_8f2c1a9d
Respostas
200
Métricas agregadas por janela.
JSON
{
"last24h": {
"total": 142,
"success": 138,
"failed": 2,
"queued": 2,
"avgDurationMs": 215
},
"last7d": {
"total": 1034,
"success": 1020,
"failed": 8,
"queued": 6,
"avgDurationMs": 198
}
}Exemplos
cURL
curl "https://api.pagnovo.com/v2/webhooks/wh_8f2c1a9d/metrics" \
-H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)"