Counters: Routen
Run Commands
Der einzige Einstiegspunkt für die Zähler Ihres Kontos. Senden Sie 1 bis 20 Befehle in einem Request und erhalten Sie ein Ergebnis pro Befehl.
https://g.sendcorex.com/v1/countersDerselbe Umschlag wie bei Logs und Contacts. Fragen Sie Summen, diesen Monat und die letzten 30 Tage in einem Request ab.
Fehler werden pro Befehl gemeldet. Ein fehlgeschlagener Befehl stoppt die anderen nicht, und der HTTP-Status bleibt 200.
Body-Parameter
commandsobject[]erforderlich1 bis 20 Befehle, der Reihe nach ausgeführt. Der gesamte Body darf bis zu 1 MB groß sein.
commands[].commandstringerforderlichget_totals,get_month,get_months,get_dailyoderget_hourly.commands[].argsobjectoptionalDie Argumente des Befehls.
commands[].idstringoptionalIhr eigener Bezeichner für das Ergebnis. Standard ist der Index (
"0","1"…).
Schnellstart
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);
}Antwort
{
"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
}
}
]
}Antwortfelder
typeImmer
SUCCESS, wenn der Request selbst angenommen wurde.results[].command / id / typeWelcher Befehl, Ihre ID (oder der Index) und
SUCCESSoderERROR.results[].dataDie Ausgabe des Befehls. Nur vorhanden, wenn
typeSUCCESSist.results[].code / messageDer Fehler. Nur vorhanden, wenn
typeERRORist.
Authentifizierung
Verwenden Sie den API key, den Sie im Dashboard unter Developers → API Keys erstellen, mit dem Scope counters:read.
AuthorizationSenden Sie
Authorization: <api key>oderAuthorization: Bearer <api key>.counters:readDer einzige Scope, den diese Route braucht. Er ist nur lesend.
Mailbox-TokensDer Webmail-Token funktioniert hier nicht. Er wird mit
WRONG_CREDENTIAL_TYPEabgelehnt.
Was gezählt wird
Jede E-MailAPI, SMTP-Relay und Kampagnen, alles zusammen. Jede E-Mail zählt einmal, sobald sie ihr endgültiges Ergebnis hat.
LiveDie Zähler bewegen sich wenige Sekunden nach jedem Zustellergebnis. Es gibt keinen täglichen Batch.
Stunden und Monate in UTCget_hourlyundget_month(s)verwenden UTC.get_dailybildet die Tage in der angefragten Zeitzone.
Rate limits und Cache
15 Requests / SekundePro IP + API key. Darüber erhalten Sie HTTP 429 mit
Retry-After.Lese-Cache: 1,5 sDerselbe Befehl mit denselben Args innerhalb von 1,5 Sekunden liefert dasselbe Ergebnis.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 400
INVALID_JSONDer Body ist nicht {"commands":[...]} oder größer als 1 MB.
- 400
INVALID_ARGSDer Request enthält keine Befehle oder mehr als 20.
- 401
MISSING_AUTH_HEADEREs wurde kein Authorization-Header gesendet.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 401
API_KEY_EXPIREDDer API key hat das im Dashboard festgelegte Ablaufdatum überschritten.
- 401
WRONG_CREDENTIAL_TYPEEs wurde ein Mailbox-Token gesendet. Die Counters API braucht einen API key aus dem Dashboard.
- 403
IP_NOT_ALLOWEDDer Request kam von einer IP, die nicht zu den erlaubten IPs des Keys gehört.
- 403
ACCOUNT_BLOCKEDDas Konto ist gesperrt.
- 403
MISSING_SCOPEDer Key hat `counters:read` nicht, daher kann kein Befehl ausgeführt werden.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.
- 503
AUTH_UNAVAILABLEDie Authentifizierung ist vorübergehend nicht verfügbar. Versuchen Sie es erneut.
- CMD
UNKNOWN_COMMANDDer Befehlsname existiert nicht.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.