Counters: Rute
Run Commands
Satu-satunya titik masuk untuk penghitung akun Anda. Kirim 1 hingga 20 perintah dalam satu request dan dapatkan satu hasil per perintah.
https://g.sendcorex.com/v1/countersEnvelope-nya sama dengan Logs dan Contacts. Minta total, bulan ini, dan 30 hari terakhir dalam satu request.
Error dilaporkan per perintah. Perintah yang gagal tidak menghentikan perintah lain, dan status HTTP tetap 200.
Parameter body
commandsobject[]wajib1 hingga 20 perintah, dijalankan berurutan. Seluruh body bisa berukuran hingga 1 MB.
commands[].commandstringwajibget_totals,get_month,get_months,get_daily, atauget_hourly.commands[].argsobjectopsionalArgumen perintah.
commands[].idstringopsionalPengenal Anda sendiri untuk hasilnya. Default-nya indeks (
"0","1"…).
Mulai cepat
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);
}Respons
{
"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
}
}
]
}Field respons
typeSelalu
SUCCESSjika request itu sendiri diterima.results[].command / id / typePerintah yang mana, id Anda (atau indeks), dan
SUCCESSatauERROR.results[].dataOutput perintah. Hanya ada jika
typebernilaiSUCCESS.results[].code / messageError-nya. Hanya ada jika
typebernilaiERROR.
Autentikasi
Gunakan API key yang Anda buat di dashboard, di Developers → API Keys, dengan scope counters:read.
AuthorizationKirim
Authorization: <api key>atauAuthorization: Bearer <api key>.counters:readSatu-satunya scope yang dibutuhkan rute ini. Hanya baca.
Token mailboxToken webmail tidak berfungsi di sini. Token itu ditolak dengan
WRONG_CREDENTIAL_TYPE.
Apa yang dihitung
Setiap emailAPI, SMTP relay, dan kampanye, semuanya bersama. Setiap email dihitung sekali, saat mendapat hasil akhirnya.
Real-timePenghitung bergerak beberapa detik setelah setiap hasil pengiriman. Tidak ada batch harian.
Jam dan bulan dalam UTCget_hourlydanget_month(s)memakai UTC.get_dailymembentuk hari di zona waktu yang Anda minta.
Rate limit dan cache
15 request / detikPer IP + API key. Di atas itu Anda mendapat HTTP 429 dengan
Retry-After.Cache baca: 1,5 dtkPerintah yang sama dengan args yang sama dalam 1,5 detik mengembalikan hasil yang sama.
Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 400
INVALID_JSONBody bukan {"commands":[...]} atau lebih besar dari 1 MB.
- 400
INVALID_ARGSRequest tidak memiliki perintah atau lebih dari 20.
- 401
MISSING_AUTH_HEADERTidak ada header Authorization yang dikirim.
- 401
INVALID_API_KEYAPI key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.
- 401
API_KEY_EXPIREDAPI key telah melewati tanggal kedaluwarsa yang diatur di dashboard.
- 401
WRONG_CREDENTIAL_TYPEYang dikirim adalah token mailbox. Counters API membutuhkan API key dari dashboard.
- 403
IP_NOT_ALLOWEDRequest berasal dari IP yang tidak termasuk IP yang diizinkan untuk key ini.
- 403
ACCOUNT_BLOCKEDAkun diblokir.
- 403
MISSING_SCOPEKey tidak memiliki `counters:read`, jadi tidak ada perintah yang bisa dijalankan.
- 429
RATE_LIMITEDLebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.
- 503
AUTH_UNAVAILABLEAutentikasi sementara tidak tersedia. Coba lagi.
- CMD
UNKNOWN_COMMANDNama perintah tidak ada.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.