Logs: Membaca
Daftar log
Log pengiriman Anda, terbaru lebih dulu, hingga 50 per halaman. Filter berdasarkan status, penerima, subjek, domain, pengirim, dan tanggal, dalam kombinasi apa pun.
https://g.sendcorex.com/v1/logscommand: list_logsMembutuhkan scope logs:read pada API key Anda.
Filter digabungkan dengan AND. Tanpa after, Anda mendapatkan 60 hari terakhir, yaitu lamanya log disimpan.
Email warm-up tidak pernah muncul di sini, dan body email tidak pernah menjadi bagian dari daftar. Gunakan Get Logs dengan include_content untuk membacanya.
Argumen
statusstring | string[]opsionaldelivered,bounced,spam,rate_limited, ataunot_sent, atau daftar dari nilai-nilai itu. Tanpa ini Anda mendapatkan kelimanya.mis.
"bounced"recipientstringopsionalAlamat email lengkap. Huruf besar/kecil dan spasi di sekitarnya diabaikan.
mis.
"ana@acme.com"subjectstringopsionalKata-kata dari subjek. Kata utuh, dan semua kata harus ada:
order shippedmenemukan "Your order #1042 has shipped",ordtidak. Aksen dan huruf besar/kecil diabaikan.mis.
"order shipped"searchstringopsionalTeks bebas, untuk kotak pencarian. Jika ada
@dianggap penerima, selain itu dianggap kata di subjek.mis.
"ana@acme.com"domainstringopsionalDomain penerima, persis.
mis.
"gmail.com"fromstringopsionalAlamat pengirim, persis.
mis.
"noreply@yourdomain.com"afterstring | numberopsionalHanya log yang dikirim pada atau setelah saat ini. ISO 8601,
YYYY-MM-DD(tengah malam UTC), atau epoch dalam milidetik. Default-nya 60 hari yang lalu.mis.
"2026-10-01"beforestring | numberopsionalHanya log yang dikirim sebelum saat ini. Format yang sama.
mis.
"2026-10-17T00:00:00Z"limitnumberopsionalUkuran halaman, dari 1 hingga 50. Default-nya 50.
mis.
50cursorstringopsionalnext_cursordari halaman sebelumnya. Kirim dengan filter yang sama.
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/logs',
{
commands: [
{
command: "list_logs",
args: {
status: "bounced",
after: "2026-10-01",
limit: 50
}
}
]
},
{ 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": "list_logs",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"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": true,
"next_cursor": "MDAwMDAwMDA4MzowOjgyMzkzMTU5OTg3OTU6M2YyYTFi",
"partial": false,
"total": 1240,
"total_exact": true
}
}
]
}Field respons
logsLog di halaman ini, terbaru lebih dulu. Masing-masing memiliki field di bawah.
countJumlah log di halaman ini.
has_more / next_cursorSelama
has_morebernilaitrue, kirimnext_cursorsebagaicursordengan filter yang sama.partialtruejika pencarian mencapai batas waktunya sebelum halaman terisi. Halaman bisa berisi lebih sedikit log, bahkan nol, dannext_cursormelanjutkan dari titik berhentinya.total / total_exactJumlah log yang cocok dengan filter, hanya di halaman pertama (permintaan tanpa
cursor). Di halaman berikutnya keduanya bernilainull, jadi simpan nilai pertama.totalhanya berisi angka jika jumlahnya pasti (total_exact: true). Dengantotal: nulldantotal_exact: false, log terlalu banyak untuk dihitung; jika keduanyanull, pencarian tidak bisa dihitung (misalnya subjek tanpa kata yang terindeks). Dalam kedua kasus, lanjutkan paginasi denganhas_more.logs[].idID email (sebuah UUID). Ini adalah
idyang Anda terima saat mengirim, dan yang Anda berikan ke Get Logs.logs[].to / logs[].domainPenerima dan domain penerima.
logs[].from_domainDomain pengirim (bagian setelah @ di
from).logs[].fromAlamat pengirim.
logs[].subjectBaris subjek.
logs[].statusdelivered,bounced,spam,rate_limited, ataunot_sent.status_codeadalah hal yang sama dalam bentuk angka.logs[].responseJawaban server penerima, misalnya
250 2.0.0 OKatau alasan bounce550.logs[].messageDetail tambahan dari Sendcorex tentang pengiriman, jika ada.
logs[].blocked / logs[].block_reasontruejika Sendcorex tidak mengirim ke penerima ini (disupresi atau dibatasi), beserta alasannya.logs[].retriesBerapa kali pengiriman dicoba ulang.
logs[].tracking_idid pengiriman internal. Webhook bounce dan complaint membawa nilai yang sama.
logs[].sent_at / logs[].updated_atKapan email dikirim, dan kapan statusnya terakhir berubah. ISO 8601, UTC.
Status
deliveredServer penerima menerima email.
bouncedServer penerima menolaknya secara permanen: alamatnya tidak ada, domainnya tidak menerima email…
spamServer penerima menolaknya sebagai spam.
rate_limitedServer penerima terus menundanya dan percobaan ulang habis.
not_sentTidak terkirim karena kondisi akun Anda (misalnya kredit habis, akun diblokir atau dibatasi, domain pengirim terdaftar di Spamhaus atau tanpa DKIM, atau From tidak valid). Ini bukan bounce. Alasan pastinya ada di
response.
Email yang masih menunggu percobaan ulang belum ada di sini: email tersebut muncul saat mencapai salah satu dari lima status ini.
Paginasi
Lanjutkan selama has_more bernilai true. Jangan berhenti di halaman yang pendek atau kosong: jika partial bernilai true, pencarian kehabisan waktu pada panggilan itu, bukan kehabisan log.
Node.js
const logs = [];
let cursor;
do {
const [result] = await call({
command: 'list_logs',
args: { status: 'bounced', after: '2026-10-01', ...(cursor ? { cursor } : {}) },
});
logs.push(...result.data.logs);
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);call adalah helper apa pun yang mem-POST { commands: [...] } ke /v1/logs dan mengembalikan results, seperti di Run Commands.
Cursor hanya berfungsi dengan filter asalnya. Ubah satu filter dan Anda mendapat INVALID_CURSOR: mulai lagi tanpa cursor.
Memantau bounce baru
Untuk bereaksi terhadap bounce (atau apa pun) saat terjadi, lakukan polling dengan after diatur ke sent_at terbaru yang pernah Anda lihat. after mencakup saat tersebut, jadi log terakhir kembali sekali lagi: lewati id yang sudah Anda miliki.
Node.js
const seen = new Set();
let since = new Date(Date.now() - 3600_000).toISOString(); // start with the last hour
setInterval(async () => {
let cursor;
do {
const [result] = await call({
command: 'list_logs',
args: { status: 'bounced', after: since, ...(cursor ? { cursor } : {}) },
});
for (const log of result.data.logs) {
if (seen.has(log.id)) continue;
seen.add(log.id);
if (log.sent_at > since) since = log.sent_at;
await removeFromMyList(log.to, log.response); // your code
}
cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);
}, 10_000);Pembacaan identik dalam 1,5 detik berbagi satu hasil, jadi beberapa worker yang mem-polling hal yang sama tidak menambah beban. Jika Anda butuh event tepat saat terjadi, gunakan webhook bounced.
Contoh lainnya
Body request
{
"commands": [
{
"command": "list_logs",
"id": "ana",
"args": {
"recipient": "ana@acme.com"
}
},
{
"command": "list_logs",
"id": "shipped",
"args": {
"subject": "order shipped",
"status": "delivered",
"after": "2026-10-10"
}
},
{
"command": "list_logs",
"id": "gmail_spam",
"args": {
"domain": "gmail.com",
"status": [
"spam",
"bounced"
]
}
},
{
"command": "list_logs",
"id": "one_day",
"args": {
"after": "2026-10-16",
"before": "2026-10-17",
"limit": 20
}
}
]
}Log
List Logs dan Get Logs mengembalikan struktur yang sama.
Log
{
"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"
}Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
INVALID_API_KEYAPI key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.
- 429
RATE_LIMITEDLebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.
- CMD
MISSING_SCOPEAPI key tidak memiliki `logs:read`.
- CMD
INVALID_ARGSAda argumen yang tidak valid: status tidak dikenal, penerima bukan email lengkap, limit di luar rentang, id bukan UUID, after lebih lambat dari before…
- CMD
INVALID_CURSORCursor tidak valid, atau berasal dari pencarian atau akun lain. Mulai lagi tanpa cursor.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.