Counters: Membaca

Ambil harian

Hari per hari di zona waktu Anda, untuk grafik. Hari tanpa pengiriman dikembalikan sebagai nol, jadi deretnya tidak berlubang.

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

Membutuhkan scope counters:read pada API key Anda.

i

Hingga 400 hari per perintah.

Argumen

  • fromstringwajib

    Hari pertama, YYYY-MM-DD, inklusif, dalam timezone.

    mis. "2026-10-01"

  • tostringwajib

    Hari terakhir, YYYY-MM-DD, inklusif, dalam timezone.

    mis. "2026-10-17"

  • timezonestringopsional

    Zona waktu IANA. Batas hari mengikutinya, termasuk daylight saving. Default-nya UTC.

    mis. "America/Sao_Paulo"

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/counters',
  {
    commands: [
      {
        command: "get_daily",
        args: {
          from: "2026-10-01",
          to: "2026-10-17",
          timezone: "Asia/Kuala_Lumpur"
        }
      }
    ]
  },
  { 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_daily",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 18,
      "data": {
        "timezone": "Asia/Kuala_Lumpur",
        "daily": [
          {
            "day": "2026-10-17",
            "delivered": 2104,
            "bounced": 31,
            "blocked": 5,
            "complaints": 1,
            "rate_limited": 4,
            "total": 2144,
            "delivered_rate": 98.13,
            "bounce_rate": 1.45,
            "blocked_rate": 0.23,
            "complaint_rate": 0.05,
            "rate_limited_rate": 0.19
          }
        ],
        "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
        }
      }
    }
  ]
}

Field respons

  • timezone

    Zona waktu yang dipakai untuk membentuk hari.

  • daily

    Satu entri per hari dari from hingga to, terlama lebih dulu, termasuk nol. Masing-masing memiliki day (YYYY-MM-DD) dan penghitungnya.

  • totals

    Jumlah untuk periode tersebut.

  • delivered

    Email yang diterima server penerima.

  • bounced

    Email yang tidak berhasil masuk: ditolak server penerima, kedaluwarsa di antrean, atau dihentikan sebelum dikirim. Alasan masing-masing ada di Bounces & Complaints.

  • blocked

    Email yang ditolak server penerima sebagai spam, karena kebijakan, atau reputasi saat pengiriman. Alamatnya baik-baik saja: masalahnya ada pada pengiriman (kualitas daftar, volume, autentikasi, konten).

  • complaints

    Penerima yang melaporkan email Anda sebagai spam setelah menerimanya: feedback loop (Outlook, Yahoo…) dan laporan penyalahgunaan. Tidak termasuk dalam total, karena email tersebut sudah dihitung sebagai terkirim.

  • rate_limited

    Email yang terus ditunda server penerima sampai percobaan ulang habis.

  • total

    delivered + bounced + blocked + rate_limited: setiap email yang mendapat hasil.

  • delivered_rate / bounce_rate / blocked_rate / complaint_rate / rate_limited_rate

    Setiap penghitung sebagai persentase dari total, dengan 2 desimal. 0 jika total bernilai 0.

Grafik 30 hari terakhir

Node.js

const to = new Date().toISOString().slice(0, 10);
const from = new Date(Date.now() - 29 * 86400_000).toISOString().slice(0, 10);
const [result] = await call({ command: 'get_daily', args: { from, to, timezone: Intl.DateTimeFormat().resolvedOptions().timeZone } });

const labels = result.data.daily.map((d) => d.day);
const delivered = result.data.daily.map((d) => d.delivered);
const bounced = result.data.daily.map((d) => d.bounced);
i

call adalah helper apa pun yang mem-POST { commands: [...] } ke /v1/counters dan mengembalikan results.

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.