Counters: Membaca
Ambil per jam
Jam per jam (UTC), untuk melihat bagaimana pengiriman berjalan saat ini. Hanya jam yang ada pengirimannya yang ditampilkan.
https://g.sendcorex.com/v1/counterscommand: get_hourlyMembutuhkan scope counters:read pada API key Anda.
Hingga 7 hari per perintah.
Argumen
fromstringwajibAwal, RFC 3339. Jam tempat nilai ini berada ikut disertakan.
mis.
"2026-10-17T00:00:00Z"tostringwajibAkhir, RFC 3339. Jam tempat nilai ini berada ikut disertakan.
mis.
"2026-10-17T23:59:59Z"
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/counters',
{
commands: [
{
command: "get_hourly",
args: {
from: "2026-10-17T00:00:00Z",
to: "2026-10-17T23:59:59Z"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respons
{
"type": "SUCCESS",
"results": [
{
"command": "get_hourly",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"hourly": [
{
"hour": "2026-10-17T06:00:00Z",
"delivered": 182,
"bounced": 3,
"blocked": 1,
"complaints": 0,
"rate_limited": 0
}
]
}
}
]
}Field respons
hourlySatu entri per jam yang ada pengirimannya, terlama lebih dulu.
hourly[].hourAwal jam, RFC 3339 UTC.
hourly[].delivered / bounced / blocked / complaints / rate_limitedPenghitung untuk jam tersebut (tanpa total atau rasio di sini).
Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
INVALID_API_KEYAPI key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.
- 429
RATE_LIMITEDLebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.
- CMD
MISSING_SCOPEAPI key tidak memiliki `counters:read`.
- CMD
INVALID_ARGSAda argumen yang tidak valid: bulan yang bukan YYYY-MM, hari yang bukan YYYY-MM-DD, zona waktu tidak dikenal, from lebih lambat dari to, rentang yang terlalu panjang…
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.