Logs

Ketahui apa yang terjadi pada setiap email

Cari pengiriman Anda berdasarkan status, penerima, subjek, dan tanggal, baca email apa pun berdasarkan id-nya, dan pantau bounce saat masuk, semuanya melalui satu endpoint.

  • Perintah JSON
  • 50 per halaman
  • Filter dan pencarian
  • 60 hari terakhir
  • Hanya baca
POSThttps://g.sendcorex.com/v1/logslogs:read

Cara kerjanya

Satu log per email

Setiap email yang Anda kirim mendapat log berisi penerima, subjek, status, dan jawaban server penerima. id-nya sama dengan yang Anda terima saat mengirim.

Satu endpoint, dua perintah

list_logs mencari dan membagi log Anda per halaman; get_logs membacanya berdasarkan id. Keduanya dikirim ke POST /v1/logs, hingga 20 perintah per request.

Dibuat untuk polling

Minta bounce baru setiap beberapa detik tanpa khawatir soal beban: pembacaan berulang berbagi satu hasil, dan email warm-up tidak pernah mengganggu.

Mulai

Hanya key yang dibutuhkan sebelum request pertama Anda.

  1. 1

    Buat API key dengan logs:read

    Di dashboard, buka Developers → API Keys dan buat key dengan scope logs:read. Anda bisa menambahkannya ke key yang sudah Anda pakai untuk mengirim.

    Token webmail tidak berfungsi di sini. Logs memakai API key dari dashboard.

  2. 2

    Cari log Anda

    List Logs menerima kombinasi apa pun dari status, penerima, kata di subjek, domain, pengirim, dan tanggal, lalu mengembalikan 50 log per halaman.

  3. 3

    Baca satu email

    Get Logs membaca hingga 50 log berdasarkan id. Tambahkan include_content untuk melihat HTML yang dikirimkan.

Log

Kedua perintah mengembalikan log dengan struktur ini.

{
  "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"
}
status

delivered, bounced, spam, atau rate_limited. Filter berdasarkan satu atau beberapa.

response

Jawaban persis dari server penerima. Untuk bounce, jawaban ini menyebutkan alasannya.

blocked

true jika Sendcorex tidak mengirim ke alamat ini, misalnya karena alamat tersebut disupresi.

content

Secara default bukan bagian dari log. Get Logs mengembalikan HTML dengan include_content.

Request pertama Anda

Dua pencarian dalam satu request: bounce Anda bulan ini, dan email terakhir ke satu pelanggan. Ganti SENDCOREX_API_KEY dengan API key Anda.

curl -X POST 'https://g.sendcorex.com/v1/logs' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "list_logs", "args": { "status": "bounced", "after": "2026-10-01" } },
    { "command": "list_logs", "args": { "recipient": "ana@acme.com", "limit": 10 } }
  ]
}'

Anda mendapat satu hasil per perintah, masing-masing dengan logs dan next_cursor untuk halaman berikutnya. Request yang sama dalam 8 bahasa ada di List Logs.

Tugas umum

Bersihkan bounce dari daftar Anda

Lakukan polling log bounced setiap beberapa detik dengan after diatur ke log terakhir yang Anda lihat, lalu hapus alamat-alamat itu di sisi Anda.

Memantau bounce baru

Jawab "apakah email saya sampai?"

Cari pelanggan berdasarkan penerima dan tampilkan status serta respons server dari email terakhir mereka.

List Logs

Periksa satu pengiriman

Simpan id yang Anda terima saat mengirim, lalu baca log-nya nanti dengan Get Logs.

Get Logs

Lihat apa yang dikirimkan

Get Logs dengan include_content mengembalikan HTML, untuk layar dukungan atau audit.

Membaca body

Referensi lengkap

Semua yang bertanda CMD adalah perintah yang dikirim melalui POST /v1/logs, hingga 20 per request.