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.
https://g.sendcorex.com/v1/logsEnvelope-nya sama dengan Contacts: setiap pembacaan adalah perintah yang dikirim ke rute ini. Halaman-halaman di bawah ini mendokumentasikan setiap perintah dan argumennya.
Error dilaporkan per perintah. Perintah yang gagal tidak menghentikan perintah lain, dan status HTTP tetap 200.
Parameter body
commandsobject[]wajib1 hingga 20 perintah, dijalankan berurutan. Seluruh body bisa berukuran hingga 1 MB.
commands[].commandstringwajiblist_logsatauget_logs.commands[].argsobjectopsionalArgumen perintah. Nilai apa pun bisa berupa
$refke hasil perintah sebelumnya.commands[].idstringopsionalPengenal 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
typeSelalu
SUCCESSjika request itu sendiri diterima.results[].commandPerintah yang menghasilkan hasil ini.
results[].ididyang Anda kirim, atau indeks perintah.results[].typeSUCCESSatauERROR.results[].took_msWaktu yang dibutuhkan perintah di dalam server. Sisa waktu request adalah jaringan.
results[].dataOutput perintah. Hanya ada jika
typebernilaiSUCCESS.results[].code / messageError-nya. Hanya ada jika
typebernilaiERROR.
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.
AuthorizationKirim
Authorization: <api key>atauAuthorization: Bearer <api key>.logs:readSatu-satunya scope yang dibutuhkan logs. Hanya baca: tidak ada apa pun di rute ini yang mengubah data.
Token mailboxToken webmail tidak berfungsi di sini. Token itu ditolak dengan
WRONG_CREDENTIAL_TYPE.IP yang diizinkanJika key memiliki allowlist IP, request dari IP lain mendapat
403 IP_NOT_ALLOWED.PencabutanKey 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 pengirimanSetiap email yang Anda kirim mendapat satu log, yang diperbarui saat pengiriman mendapat hasil.
60 hariLog disimpan selama 60 hari. Log yang lebih lama hilang, dan id-nya kembali di
not_found.Tanpa warm-upEmail yang dikirim oleh warm-up inbox tidak pernah muncul, jadi polling hanya mengembalikan trafik Anda yang sebenarnya.
Tanpa body secara defaultDaftar 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 / detikPuncak 15. Respons yang disajikan dari cache juga dihitung.
15 bersamaanPaling 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 dtkPembacaan 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.
- 400
INVALID_JSONBody bukan {"commands":[...]} atau lebih besar dari 1 MB.
- 400
INVALID_ARGSRequest tidak memiliki perintah atau lebih dari 20.
- 401
MISSING_AUTH_HEADERTidak ada header Authorization yang dikirim.
- 401
INVALID_API_KEYAPI key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.
- 401
API_KEY_EXPIREDAPI key telah melewati tanggal kedaluwarsa yang diatur di dashboard.
- 401
WRONG_CREDENTIAL_TYPEYang dikirim adalah token mailbox. Logs membutuhkan API key dari dashboard.
- 403
IP_NOT_ALLOWEDRequest berasal dari IP yang tidak termasuk IP yang diizinkan untuk key ini.
- 403
ACCOUNT_BLOCKEDAkun diblokir.
- 403
MISSING_SCOPEKey tidak memiliki `logs:read`, jadi tidak ada perintah yang bisa dijalankan.
- 429
RATE_LIMITEDLebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.
- 503
AUTH_UNAVAILABLEAutentikasi sementara tidak tersedia. Coba lagi.
- CMD
UNKNOWN_COMMANDNama perintah tidak ada.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.