Logs: Membaca

Ambil log

Baca hingga 50 log berdasarkan ID email, yaitu `id` yang Anda terima saat mengirim. Tambahkan `include_content` untuk mendapatkan HTML yang dikirimkan.

POSThttps://g.sendcorex.com/v1/logscommand: get_logs
i

Membutuhkan scope logs:read pada API key Anda.

i

Mencari sebuah ID biayanya sama berapa pun jumlah email yang Anda kirim: tidak ada pemindaian di baliknya.

Argumen

  • idsstring[]opsional

    Hingga 50 ID email (UUID). id yang berulang dihitung sekali.

    mis. ["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]

  • idstringopsional

    Satu ID email. Gunakan ini atau ids.

    mis. "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"

  • include_contentbooleanopsional

    Kembalikan juga HTML setiap email. Dengan ini, batasnya 10 id per perintah.

    mis. true

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/logs',
  {
    commands: [
      {
        command: "get_logs",
        args: {
          ids: [
            "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
            "00000000-0000-4000-8000-000000000000"
          ]
        }
      }
    ]
  },
  { 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_logs",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 18,
      "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": [
          "00000000-0000-4000-8000-000000000000"
        ]
      }
    }
  ]
}

Field respons

  • logs

    Log yang ditemukan, sesuai urutan yang Anda minta.

  • not_found

    id yang tidak ada di akun Anda, berumur lebih dari 60 hari, atau milik email warm-up.

  • logs[].id

    ID email (sebuah UUID). Ini adalah id yang Anda terima saat mengirim, dan yang Anda berikan ke Get Logs.

  • logs[].to / logs[].domain

    Penerima dan domain penerima.

  • logs[].from_domain

    Domain pengirim (bagian setelah @ di from).

  • logs[].from

    Alamat pengirim.

  • logs[].subject

    Baris subjek.

  • logs[].status

    delivered, bounced, spam, rate_limited, atau not_sent. status_code adalah hal yang sama dalam bentuk angka.

  • logs[].response

    Jawaban server penerima, misalnya 250 2.0.0 OK atau alasan bounce 550.

  • logs[].message

    Detail tambahan dari Sendcorex tentang pengiriman, jika ada.

  • logs[].blocked / logs[].block_reason

    true jika Sendcorex tidak mengirim ke penerima ini (disupresi atau dibatasi), beserta alasannya.

  • logs[].retries

    Berapa kali pengiriman dicoba ulang.

  • logs[].tracking_id

    id pengiriman internal. Webhook bounce dan complaint membawa nilai yang sama.

  • logs[].sent_at / logs[].updated_at

    Kapan email dikirim, dan kapan statusnya terakhir berubah. ISO 8601, UTC.

  • logs[].content.html

    HTML yang dikirimkan. Hanya dengan include_content: true; null jika body tidak disimpan.

Membaca body

Body adalah bagian terberat dari sebuah log, jadi hanya dikembalikan jika Anda memintanya. Isinya HTML persis seperti saat dikirimkan: jika tracking aktif, HTML bisa berisi piksel pelacakan dan link yang ditulis ulang.

Body request

{
  "commands": [
    {
      "command": "get_logs",
      "args": {
        "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
        "include_content": true
      }
    }
  ]
}
!

Merender HTML tersebut bisa memuat piksel pelacakan dan terhitung sebagai open. Tampilkan dalam iframe ber-sandbox dengan gambar eksternal diblokir, seperti yang dilakukan dashboard.

Detail untuk satu halaman List Logs

Rangkai kedua perintah dengan $ref: id dari daftar langsung masuk ke Get Logs, dalam satu request.

Body request

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

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 `logs:read`.

  • CMDINVALID_ARGS

    Ada argumen yang tidak valid: status tidak dikenal, penerima bukan email lengkap, limit di luar rentang, id bukan UUID, after lebih lambat dari before…

  • CMDINTERNAL

    Error server. Detailnya hanya ditulis ke log server.