Menerima Email: Kirim & kepercayaan
Ambil pelacakan
Mengembalikan pembukaan dan klik email yang dikirim oleh mailbox ini. Hanya baca.
https://g.sendcorex.com/v1command: get_trackingHanya pesan yang dikirim dengan pelacakan yang muncul di hasil.
Pembukaan dari bot dan proxy tidak dihitung.
Angka pembukaan adalah perkiraan: beberapa aplikasi email memuat gambar otomatis atau memblokirnya.
Status setiap pesan disimpan selama 180 hari.
Argumen
idsstring[]wajib1 sampai 200
message_uidpesan terkirim. Berasal dari Sent, dari responssend_email/reply, atau darilist_messages.
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "get_tracking",
args: {
ids: [
"Vj0xQUJDMTIz",
"Vj0xQUJDMTI0"
]
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
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_tracking",
"id": "0",
"type": "SUCCESS",
"data": {
"tracking": {
"Vj0xQUJDMTIz": {
"track_opens": true,
"track_clicks": true,
"opens": 3,
"clicks": 1,
"first_open_at": "2026-11-21T07:10:00Z",
"last_open_at": "2026-11-21T09:42:00Z",
"last_click_at": "2026-11-21T09:43:00Z",
"unsubscribe": true,
"unsubscribes": 0,
"recipients": [
{
"email": "ana@empresa.com",
"opens": 3,
"clicks": 1,
"last_at": "2026-11-21T09:43:00Z",
"unsubscribed": false,
"urls": [
{
"url": "https://acme.com/pricing",
"at": "2026-11-21T09:43:00Z",
"clicks": 1
}
]
}
]
}
}
}
}
]
}Field respons
tracking.<message_uid>Satu entri per pesan yang dikirim dengan pelacakan. Pesan tanpa pelacakan tidak dicantumkan.
track_opens / track_clicksApa yang dilacak saat email dikirim.
opens / clicksTotal dari semua penerima.
first_open_at / last_open_at / last_click_atAktivitas pertama dan terakhir (UTC), atau
null.unsubscribe / unsubscribesApakah email memiliki link berhenti berlangganan, dan berapa penerima yang berhenti berlangganan lewat link itu.
recipientsPer penerima:
email,opens,clicks,last_at,unsubscribed, danurls(setiap tautan yang diklik, terbaru dulu, denganurl,atklik terakhir, danclicks;[]jika orang itu tidak mengeklik).
Pelacakan
Cara pembukaan dan klik diukur.
Pembukaan
Setiap email membawa piksel tak terlihat. Saat aplikasi penerima memuatnya, satu pembukaan dihitung. Beberapa aplikasi memuat gambar sendiri atau memblokirnya, jadi angkanya adalah perkiraan.
Klik
Setiap link melewati pengalihan yang menghitung klik dan langsung membawa penerima ke alamat aslinya.
Privasi
Penerima yang menolak pelacakan di halaman preferensi tidak pernah dilacak. Untuk mematikan pelacakan pada satu email, kirim track_opens: false dan track_clicks: false.
Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
TOKEN_EXPIREDAccess token sudah kedaluwarsa. Panggil Refresh Token lalu ulangi request.
- 401
INVALID_TOKENToken salah format, tidak dikenal, atau dicabut.
- 429
RATE_LIMITEDLebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.
- CMD
INVALID_ARGSArgumen wajib tidak ada atau tidak valid.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.