Bounces & Complaints: Membaca
Ambil email
Semua yang kembali untuk satu email: bounce atau pemblokirannya, keluhannya, atau alasan email itu tidak dikirim. Satu pencarian, tanpa pemindaian.
https://g.sendcorex.com/v1/feedbackcommand: get_emailMembutuhkan scope feedback:read pada API key Anda.
Satu email memiliki paling banyak satu event dari setiap kelompok: satu bounce (bounce_hard, bounce_soft, atau blocked), satu complaint, dan satu dropped.
Argumen
email_idstringwajibID email, yaitu
idyang Anda terima saat mengirim.mis.
"9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/feedback',
{
commands: [
{
command: "get_email",
args: {
email_id: "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
},
{ 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_email",
"id": "0",
"type": "SUCCESS",
"took_ms": 18,
"data": {
"events": [
{
"email_id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
"kind": "bounce_hard",
"source": "smtp",
"recipient": "old.address@gmail.com",
"from": "noreply@yourdomain.com",
"smtp_code": 550,
"enhanced_code": "5.1.1",
"diagnostic": "550-5.1.1 The email account that you tried to reach does not exist.",
"at": "2026-10-17T05:58:44.031Z"
}
]
}
}
]
}Field respons
eventsEvent dari email ini. Kosong jika tidak ada yang kembali (email terkirim, atau berumur lebih dari 90 hari).
events[].email_idID email (sebuah UUID):
idyang Anda terima saat mengirim, dan id yang sama dengan di Logs dan webhook.events[].kindApa yang terjadi:
bounce_hard,bounce_soft,blocked,complaint, ataudropped. Lihat Jenis di bawah.events[].sourceDari mana kami mengetahuinya: jawaban SMTP, pesan bounce, feedback loop, laporan penyalahgunaan… Lihat Sumber di bawah.
events[].recipientAlamat tujuan email.
events[].fromAlamat pengirim.
events[].campaign_idKampanyenya, jika email termasuk dalam sebuah kampanye.
events[].smtp_code / events[].enhanced_codeKode yang dijawab server penerima, misalnya
550dan5.1.1. Hanya pada bounce dan pemblokiran.events[].diagnosticJawaban lengkap server penerima, atau alasan yang diberikan dalam laporan penyalahgunaan.
events[].reporting_mtaSiapa yang melaporkan: server yang mengirim pesan bounce, alamat feedback loop, atau
webuntuk halaman laporan.events[].atKapan terjadinya. ISO 8601, UTC.
Jawab "mengapa email saya tidak sampai?"
Baca log dan feedback-nya sekaligus: Logs memberi tahu statusnya, perintah ini memberi tahu alasannya dan siapa yang melaporkannya.
Dua request, id yang sama
{
"logs": {
"commands": [
{
"command": "get_logs",
"args": {
"id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
},
"feedback": {
"commands": [
{
"command": "get_email",
"args": {
"email_id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30"
}
}
]
}
}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 `feedback:read`.
- CMD
INVALID_ARGSAda argumen yang tidak valid: jenis tidak dikenal, `since` bukan RFC 3339, limit di luar rentang, `email_id` tidak ada…
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.