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.
https://g.sendcorex.com/v1/logscommand: get_logsMembutuhkan scope logs:read pada API key Anda.
Mencari sebuah ID biayanya sama berapa pun jumlah email yang Anda kirim: tidak ada pemindaian di baliknya.
Argumen
idsstring[]opsionalHingga 50 ID email (UUID). id yang berulang dihitung sekali.
mis.
["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]idstringopsionalSatu ID email. Gunakan ini atau
ids.mis.
"3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"include_contentbooleanopsionalKembalikan 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
logsLog yang ditemukan, sesuai urutan yang Anda minta.
not_foundid yang tidak ada di akun Anda, berumur lebih dari 60 hari, atau milik email warm-up.
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.
logs[].content.htmlHTML yang dikirimkan. Hanya dengan
include_content: true;nulljika 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.
- 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
INTERNALError server. Detailnya hanya ditulis ke log server.