Counters
Vos chiffres d'envoi, prêts pour un graphique
Livrés, bounces, bloqués, plaintes et rate limited pour tout votre compte, par heure, jour, mois ou depuis le début, avec les taux déjà calculés.
- Commandes JSON
- En temps réel
- Heure, jour, mois, total
- N'importe quel fuseau horaire
- Lecture seule
https://g.sendcorex.com/v1/counterscounters:readFonctionnement
Tout le compte
L'API, le relais SMTP et les campagnes sont comptés ensemble, une fois par e-mail, lorsque l'e-mail obtient son résultat final.
Choisissez la granularité
Depuis le début, un mois, une plage de mois, des jours dans votre propre fuseau horaire, ou des heures. Mêmes compteurs, même structure.
Taux inclus
Chaque période est fournie avec son total et les pourcentages de livrés, de bounces, de bloqués, de plaintes et de rate limited. Aucun calcul de votre côté.
Premiers pas
Seule la key est nécessaire avant votre première requête.
- 1
Créez une API key avec counters:read
Dans le dashboard, ouvrez Developers → API Keys et créez une key avec le scope counters:read, ou ajoutez-le à une key que vous utilisez déjà.
- 2
Obtenez ce mois-ci
Get Month renvoie le mois en cours avec ses taux. Get Totals vous donne tout depuis le début.
- 3
Tracez un graphique
Get Daily renvoie une entrée par jour dans votre fuseau horaire, zéros compris, prête à tracer.
Les compteurs
Chaque commande renvoie les compteurs sous cette forme, pour la période demandée.
{
"month": "2026-10",
"delivered": 48210,
"bounced": 612,
"blocked": 88,
"complaints": 9,
"rate_limited": 140,
"total": 49050,
"delivered_rate": 98.29,
"bounce_rate": 1.25,
"blocked_rate": 0.18,
"complaint_rate": 0.02,
"rate_limited_rate": 0.29
}deliveredAcceptés par le serveur destinataire.
bouncedNe sont pas passés. La raison de chacun se trouve dans Bounces & Complaints.
blockedRefusés comme spam ou par politique au moment de la livraison. L'adresse est bonne, l'envoi ne l'était pas.
complaintsDestinataires qui vous ont signalé comme spam après avoir reçu l'e-mail. Ne font pas partie du total.
*_rateChaque compteur en pourcentage du total, avec 2 décimales.
Votre première requête
Depuis le début et ce mois-ci, en une requête. Remplacez SENDCOREX_API_KEY par votre API key.
curl -X POST 'https://g.sendcorex.com/v1/counters' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "get_totals" },
{ "command": "get_month", "args": { "month": "2026-10" } }
]
}'Vous obtenez un résultat par commande : les totaux pour la première, le mois avec ses taux pour la seconde. La même requête en 8 langages se trouve dans Run Commands.
Cas d'usage courants
Un graphique de délivrabilité dans votre app
Get Daily sur les 30 derniers jours dans le fuseau horaire de l'utilisateur, et tracez les livrés face aux bounces.
Graphique des 30 derniers joursSuivez un envoi en temps réel
Get Hourly pour aujourd'hui et voyez le taux de bounce d'une campagne pendant son envoi.
Get HourlyRapport mensuel
Get Months pour l'année : une ligne par mois avec ses taux, plus le total.
Get MonthsDécouvrez pourquoi ils ont rebondi
Les compteurs vous disent combien. Bounces & Complaints vous dit quelles adresses et pourquoi.
Bounces & ComplaintsRéférence complète
Tout ce qui est marqué CMD est une commande envoyée via POST /v1/counters, jusqu'à 20 par requête.