Skip to Content
Référence APIStats Globales

Statistiques Globales

Obtenir les statistiques globales de suivi pour votre organisation.

Endpoint

GET /api/stats

Authentification

Nécessite une clé API via l’en-tête x-api-key.

Exemple de Requête

curl -X GET NEXT_PUBLIC_BASE_URL/api/stats \ -H "x-api-key: votre-cle-api"

Réponse

Renvoie les statistiques totales de suivi pour tous les emails de votre organisation.

Schéma de Réponse

ChampTypeDescription
totalEmailsnumberNombre total d’emails suivis
totalOpensnumberNombre total d’ouvertures d’email
totalClicksnumberNombre total de clics sur les liens
openRatenumberPourcentage d’emails ouverts (0-100)
clickRatenumberPourcentage d’emails avec au moins un clic (0-100)

Exemple de Réponse

{ "totalEmails": 2847, "totalOpens": 1948, "totalClicks": 689, "openRate": 68.42, "clickRate": 24.2 }

Types TypeScript

interface TrackingStats { totalEmails: number; totalOpens: number; totalClicks: number; openRate: number; clickRate: number; }

Réponses d’Erreur

StatutDescription
401 UnauthorizedClé API invalide ou manquante

Exemple d’Erreur

{ "error": "Unauthorized" }

Notes d’Utilisation

  • Taux d’Ouverture est calculé comme : (emails avec au moins une ouverture / total emails) * 100
  • Taux de Clic est calculé comme : (emails avec au moins un clic / total emails) * 100
  • Les statistiques sont agrégées sur toutes les campagnes et les emails autonomes
Last updated on
Mailpulse Documentation