Logs: Rute

Run Commands

Satu-satunya titik masuk untuk log pengiriman. Kirim 1 hingga 20 perintah dalam satu request dan dapatkan satu hasil per perintah.

POSThttps://g.sendcorex.com/v1/logs
i

Envelope-nya sama dengan Contacts: setiap pembacaan adalah perintah yang dikirim ke rute ini. Halaman-halaman di bawah ini mendokumentasikan setiap perintah dan argumennya.

i

Error dilaporkan per perintah. Perintah yang gagal tidak menghentikan perintah lain, dan status HTTP tetap 200.

Parameter body

  • commandsobject[]wajib

    1 hingga 20 perintah, dijalankan berurutan. Seluruh body bisa berukuran hingga 1 MB.

  • commands[].commandstringwajib

    list_logs atau get_logs.

  • commands[].argsobjectopsional

    Argumen perintah. Nilai apa pun bisa berupa $ref ke hasil perintah sebelumnya.

  • commands[].idstringopsional

    Pengenal Anda sendiri untuk hasilnya. Default-nya indeks ("0", "1"…). Wajib jika Anda ingin memakai $ref.

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/logs',
  {
    commands: [
      {
        command: "list_logs",
        id: "bounces",
        args: {
          status: "bounced",
          limit: 20
        }
      },
      {
        command: "get_logs",
        id: "one",
        args: {
          id: "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"
        }
      }
    ]
  },
  { 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": "list_logs",
      "id": "bounces",
      "type": "SUCCESS",
      "took_ms": 21,
      "data": {
        "logs": [
          {
            "id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
            "to": "old.address@gmail.com",
            "from": "noreply@yourdomain.com",
            "domain": "gmail.com",
            "from_domain": "yourdomain.com",
            "subject": "Your order #1042 has shipped",
            "status": "bounced",
            "status_code": 6,
            "response": "550 5.1.1 The email account that you tried to reach does not exist.",
            "message": null,
            "blocked": false,
            "block_reason": null,
            "retries": 0,
            "tracking_id": "7CK-JDL-Z2M-20261017",
            "sent_at": "2026-10-17T05:58:44.031Z",
            "updated_at": "2026-10-17T05:58:45.600Z"
          }
        ],
        "count": 1,
        "has_more": false,
        "next_cursor": null,
        "partial": false
      }
    },
    {
      "command": "get_logs",
      "id": "one",
      "type": "SUCCESS",
      "took_ms": 9,
      "data": {
        "logs": [
          {
            "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
            "to": "ana@acme.com",
            "from": "noreply@yourdomain.com",
            "domain": "acme.com",
            "from_domain": "yourdomain.com",
            "subject": "Your order #1042 has shipped",
            "status": "delivered",
            "status_code": 2,
            "response": "250 2.0.0 OK 1760684401 a1si123456",
            "message": null,
            "blocked": false,
            "block_reason": null,
            "retries": 0,
            "tracking_id": "7CK-JDL-Y1L-20261017",
            "sent_at": "2026-10-17T06:00:01.204Z",
            "updated_at": "2026-10-17T06:00:02.913Z"
          }
        ],
        "not_found": []
      }
    }
  ]
}

Field respons

  • type

    Selalu SUCCESS jika request itu sendiri diterima.

  • results[].command

    Perintah yang menghasilkan hasil ini.

  • results[].id

    id yang Anda kirim, atau indeks perintah.

  • results[].type

    SUCCESS atau ERROR.

  • results[].took_ms

    Waktu yang dibutuhkan perintah di dalam server. Sisa waktu request adalah jaringan.

  • results[].data

    Output perintah. Hanya ada jika type bernilai SUCCESS.

  • results[].code / message

    Error-nya. Hanya ada jika type bernilai ERROR.

Autentikasi

Logs memakai API key yang Anda buat di dashboard, di Developers → API Keys, dengan scope logs:read. Jenis key-nya sama dengan yang dipakai untuk mengirim email dan mengelola kontak.

  • Authorization

    Kirim Authorization: <api key> atau Authorization: Bearer <api key>.

  • logs:read

    Satu-satunya scope yang dibutuhkan logs. Hanya baca: tidak ada apa pun di rute ini yang mengubah data.

  • Token mailbox

    Token webmail tidak berfungsi di sini. Token itu ditolak dengan WRONG_CREDENTIAL_TYPE.

  • IP yang diizinkan

    Jika key memiliki allowlist IP, request dari IP lain mendapat 403 IP_NOT_ALLOWED.

  • Pencabutan

    Key di-cache selama 60 detik, jadi key yang dicabut berhenti berfungsi dalam satu menit. Tanggal kedaluwarsa diperiksa di setiap request.

Gunakan hasil sebelumnya dengan $ref

Nilai apa pun di dalam args bisa berupa {"$ref": "<id>", "path": "<path>"}. Nilai itu diganti dengan nilai yang ditemukan di path pada hasil perintah dengan id tersebut. Di path, * menelusuri sebuah daftar. Request ini menampilkan bounce terbaru dan membaca body-nya, dalam satu kali bolak-balik.

Body request

{
  "commands": [
    {
      "command": "list_logs",
      "id": "b",
      "args": {
        "status": "bounced",
        "limit": 10
      }
    },
    {
      "command": "get_logs",
      "args": {
        "ids": {
          "$ref": "b",
          "path": "logs/*/id"
        },
        "include_content": true
      }
    }
  ]
}

Isi log

  • Setiap pengiriman

    Setiap email yang Anda kirim mendapat satu log, yang diperbarui saat pengiriman mendapat hasil.

  • 60 hari

    Log disimpan selama 60 hari. Log yang lebih lama hilang, dan id-nya kembali di not_found.

  • Tanpa warm-up

    Email yang dikirim oleh warm-up inbox tidak pernah muncul, jadi polling hanya mengembalikan trafik Anda yang sebenarnya.

  • Tanpa body secara default

    Daftar tidak pernah membawa HTML. Get Logs mengembalikannya hanya dengan include_content: true.

Rate limit dan cache

Batas berlaku per IP + API key. Tidak ada antrean: jika Anda melewatinya, request ditolak dengan HTTP 429 dan header Retry-After.

  • 15 request / detik

    Puncak 15. Respons yang disajikan dari cache juga dihitung.

  • 15 bersamaan

    Paling banyak 15 request diproses pada saat yang sama. Menelusuri banyak halaman secara paralel adalah cara paling umum mencapainya: telusuri satu per satu.

  • Cache baca: 1,5 dtk

    Pembacaan yang sama (perintah dan args yang sama) dalam 1,5 detik mengembalikan hasil yang sama, dan pembacaan identik yang sedang berjalan berbagi satu kueri. Polling setiap beberapa detik tidak masalah.

Cursor

List Logs mengembalikan next_cursor selama masih ada data. Nilainya buram: kirim kembali apa adanya, dengan filter yang sama.

next_cursor

{
  "has_more": true,
  "next_cursor": "MDAwMDAwMDA4MzowOjgyMzkzMTU5OTg3OTU6M2YyYTFi",
  "partial": false
}

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 400INVALID_JSON

    Body bukan {"commands":[...]} atau lebih besar dari 1 MB.

  • 400INVALID_ARGS

    Request tidak memiliki perintah atau lebih dari 20.

  • 401MISSING_AUTH_HEADER

    Tidak ada header Authorization yang dikirim.

  • 401INVALID_API_KEY

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

  • 401API_KEY_EXPIRED

    API key telah melewati tanggal kedaluwarsa yang diatur di dashboard.

  • 401WRONG_CREDENTIAL_TYPE

    Yang dikirim adalah token mailbox. Logs membutuhkan API key dari dashboard.

  • 403IP_NOT_ALLOWED

    Request berasal dari IP yang tidak termasuk IP yang diizinkan untuk key ini.

  • 403ACCOUNT_BLOCKED

    Akun diblokir.

  • 403MISSING_SCOPE

    Key tidak memiliki `logs:read`, jadi tidak ada perintah yang bisa dijalankan.

  • 429RATE_LIMITED

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

  • 503AUTH_UNAVAILABLE

    Autentikasi sementara tidak tersedia. Coba lagi.

  • CMDUNKNOWN_COMMAND

    Nama perintah tidak ada.

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.