Counters : Routes
Run Commands
Le point d'entrée unique pour les compteurs de votre compte. Envoyez de 1 à 20 commandes en une requête et obtenez un résultat par commande.
https://g.sendcorex.com/v1/countersMême enveloppe que Logs et Contacts. Demandez les totaux, ce mois-ci et les 30 derniers jours en une seule requête.
Les erreurs sont signalées par commande. Une commande qui échoue n'arrête pas les autres, et le statut HTTP reste 200.
Paramètres du corps
commandsobject[]obligatoire1 à 20 commandes, exécutées dans l'ordre. Le corps entier peut faire jusqu'à 1 MB.
commands[].commandstringobligatoireget_totals,get_month,get_months,get_dailyouget_hourly.commands[].argsobjectfacultatifLes arguments de la commande.
commands[].idstringfacultatifVotre propre identifiant pour le résultat. Par défaut, l'index (
"0","1"…).
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/counters',
{
commands: [
{
command: "get_totals",
id: "all"
},
{
command: "get_month",
id: "now"
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
for (const result of response.data.results) {
if (result.type !== 'SUCCESS') console.error(result.id, result.code, result.message);
else console.log(result.id, result.data);
}Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "get_totals",
"id": "all",
"type": "SUCCESS",
"took_ms": 3,
"data": {
"totals": {
"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
}
}
},
{
"command": "get_month",
"id": "now",
"type": "SUCCESS",
"took_ms": 2,
"data": {
"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
}
}
]
}Champs de la réponse
typeToujours
SUCCESSlorsque la requête elle-même a été acceptée.results[].command / id / typeQuelle commande, votre id (ou l'index), et
SUCCESSouERROR.results[].dataLa sortie de la commande. Présente uniquement lorsque
typevautSUCCESS.results[].code / messageL'erreur. Présente uniquement lorsque
typevautERROR.
Authentification
Utilisez l'API key que vous créez dans le dashboard, sous Developers → API Keys, avec le scope counters:read.
AuthorizationEnvoyez
Authorization: <api key>ouAuthorization: Bearer <api key>.counters:readLe seul scope dont cette route a besoin. Il est en lecture seule.
Tokens de mailboxLe token du webmail ne fonctionne pas ici. Il est rejeté avec
WRONG_CREDENTIAL_TYPE.
Ce qui est compté
Chaque e-mailL'API, le relais SMTP et les campagnes, tous ensemble. Chaque e-mail compte une fois, lorsqu'il obtient son résultat final.
En temps réelLes compteurs bougent quelques secondes après chaque résultat de livraison. Il n'y a pas de traitement quotidien par lots.
Heures et mois en UTCget_hourlyetget_month(s)utilisent l'UTC.get_dailyconstruit les jours dans le fuseau horaire demandé.
Rate limits et cache
15 requêtes / secondePar IP + API key. Au-delà, vous recevez un HTTP 429 avec
Retry-After.Cache de lecture : 1,5 sLa même commande avec les mêmes args à moins de 1,5 seconde d'intervalle renvoie le même résultat.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 400
INVALID_JSONLe corps n'est pas {"commands":[...]} ou dépasse 1 MB.
- 400
INVALID_ARGSLa requête ne contient aucune commande ou plus de 20.
- 401
MISSING_AUTH_HEADERAucun header Authorization n'a été envoyé.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.
- 401
API_KEY_EXPIREDL'API key a dépassé la date d'expiration définie dans le dashboard.
- 401
WRONG_CREDENTIAL_TYPEUn token de mailbox a été envoyé. La Counters API nécessite une API key du dashboard.
- 403
IP_NOT_ALLOWEDLa requête provient d'une IP qui ne figure pas parmi les IP autorisées de la key.
- 403
ACCOUNT_BLOCKEDLe compte est bloqué.
- 403
MISSING_SCOPELa key n'a pas `counters:read`, donc aucune commande ne peut s'exécuter.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.
- 503
AUTH_UNAVAILABLEL'authentification est temporairement indisponible. Réessayez.
- CMD
UNKNOWN_COMMANDLe nom de la commande n'existe pas.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.