Counters: Membaca

Ambil per jam

Jam per jam (UTC), untuk melihat bagaimana pengiriman berjalan saat ini. Hanya jam yang ada pengirimannya yang ditampilkan.

POSThttps://g.sendcorex.com/v1/counterscommand: get_hourly
i

Membutuhkan scope counters:read pada API key Anda.

i

Hingga 7 hari per perintah.

Argumen

  • fromstringwajib

    Awal, RFC 3339. Jam tempat nilai ini berada ikut disertakan.

    mis. "2026-10-17T00:00:00Z"

  • tostringwajib

    Akhir, 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

  • hourly

    Satu entri per jam yang ada pengirimannya, terlama lebih dulu.

  • hourly[].hour

    Awal jam, RFC 3339 UTC.

  • hourly[].delivered / bounced / blocked / complaints / rate_limited

    Penghitung 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.

  • 401INVALID_API_KEY

    API key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.

  • 429RATE_LIMITED

    Lebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.

  • CMDMISSING_SCOPE

    API key tidak memiliki `counters:read`.

  • CMDINVALID_ARGS

    Ada 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…

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.