Analytics API

Gli endpoint di analytics restituiscono metriche di invio aggregate del tuo tenant. Usano la sessione JWT del pannello (con scope tenant) — non sono esposti tramite gli scope delle API key.

Tutti accettano un parametro opzionale ?days (predefinito 30, massimo 90) ed escludono i log rimossi dalla retention.

Riepilogo

GET /analytics/summary?days=30

Restituisce totali e tassi del periodo:

{
  "period": { "days": 30, "since": "...", "until": "..." },
  "totals": { "total": 0, "sent": 0, "opened": 0, "clicked": 0, "bounced": 0, "complained": 0, "failed": 0 },
  "rates": { "openRate": 0, "clickRate": 0, "bounceRate": 0, "complaintRate": 0 }
}

sent conta SENT + DELIVERED; i tassi sono percentuali arrotondate a un decimale.

Serie giornaliera

GET /analytics/daily?days=30

Restituisce un bucket per giorno (riempito a zero) per i grafici:

{ "days": 30, "daily": [{ "date": "2026-07-01", "sent": 0, "opened": 0, "clicked": 0, "bounced": 0 }] }

Top template

GET /analytics/top-templates?days=30

Restituisce i 10 template con piu volume di invio:

{ "top": [{ "id": "...", "name": "...", "subject": "...", "sent": 0, "opened": 0, "clicked": 0 }] }

Vedi Stati email per sapere cosa conta ogni contatore.