Counters: Membaca

Ambil beberapa bulan

Bulan per bulan, ditambah total periode. Hanya bulan yang ada pengirimannya yang ditampilkan.

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

Membutuhkan scope counters:read pada API key Anda.

Argumen

  • fromstringopsional

    Bulan pertama, YYYY-MM, inklusif. Tanpa ini, mulai dari bulan pertama yang ada pengirimannya.

    mis. "2026-01"

  • tostringopsional

    Bulan terakhir, YYYY-MM, inklusif. Tanpa ini, sampai sekarang.

    mis. "2026-10"

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/counters',
  {
    commands: [
      {
        command: "get_months",
        args: {
          from: "2026-01",
          to: "2026-10"
        }
      }
    ]
  },
  { 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_months",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 18,
      "data": {
        "months": [
          {
            "month": "2026-09",
            "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
          },
          {
            "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
          }
        ],
        "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

  • months

    Satu entri per bulan yang ada pengirimannya, terlama lebih dulu. Masing-masing memiliki month (YYYY-MM) dan penghitungnya.

  • totals

    Penghitung yang dijumlahkan selama periode, dengan rasio yang dihitung ulang.

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

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.