Karantina
Email yang Ditandai
Saat email yang dikirim ditandai sebagai potensi spam, API mengembalikan 403 alih-alih memasukkan pesan ke antrean. quarantine_id dikembalikan agar Anda bisa meninjau dan merilis email nanti.
https://mail.sendcorex.com/v3.0/sendTidak dikirim: email yang dikarantina tidak dikirim. Gunakan /quarantine/release untuk mengirimnya setelah ditinjau. Catatan kedaluwarsa setelah 3 jam.
Cara kerja
- 1
Kirim
Anda memanggil /send seperti biasa. Jika body atau subjek memicu filter spam, API menyimpan payload mentah di karantina alih-alih memasukkan email ke antrean.
- 2
Terima 403
Responsnya adalah 403 Forbidden dengan kode SPAM_DETECTED, sebuah detectionId, dan sebuah quarantine_id.
- 3
Tinjau
Periksa konten yang ditandai. Jika email sah, panggil /quarantine/release dengan quarantine_id dalam 3 jam. Body dan subjek disanitasi sebelum dikirim.
Payload 403
errorstringPesan yang mudah dibaca yang menjelaskan bahwa konten ditandai sebagai spam.
mis.
"Email content flagged as spam."codestringKode error yang bisa dibaca mesin. Selalu SPAM_DETECTED untuk email yang ditandai.
mis.
"SPAM_DETECTED"detectionIdstringID unik deteksi spam. Sertakan saat menghubungi support.
mis.
"det_8c1e5a92b7d04f36"quarantine_idstring | nullID unik pesan yang dikarantina. Kirim ke /quarantine/release untuk mengirim email. Bernilai null jika pesan tidak bisa disimpan untuk dirilis.
mis.
"qtn_3f2a1b4c8e9d4f7a"release_instructionsstring | nullPetunjuk singkat cara merilis email. null jika tidak ada quarantine_id.
mis.
"POST /v3.0/quarantine/release with { quarantine_id }"expires_instring | nullBerapa lama catatan karantina tetap tersedia untuk dirilis.
mis.
"3 hours"
Mulai cepat
import axios from 'axios';
try {
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'user@example.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Hello!',
body: '<p>Your message here.</p>',
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
console.log('Queued:', response.data.id);
} catch (err) {
if (err.response?.status === 403 && err.response.data.code === 'SPAM_DETECTED') {
// Email flagged as spam: save quarantine_id to release it later
const { quarantine_id, detectionId, expires_in } = err.response.data;
console.log('Quarantined:', quarantine_id, '| detection:', detectionId, '| expires in', expires_in);
} else {
throw err;
}
}Respons
{
"error": "Email content flagged as spam.",
"code": "SPAM_DETECTED",
"detectionId": "det_8c1e5a92b7d04f36",
"quarantine_id": "qtn_3f2a1b4c8e9d4f7a",
"release_instructions": "POST /v3.0/quarantine/release with { quarantine_id }",
"expires_in": "3 hours"
}Error
Semua kode error →Error mengembalikan objek JSON dengan error dan code.
- 401
MISSING_AUTH_HEADERTidak ada header Authorization.
- 401
INVALID_API_KEYAPI key tidak valid atau sudah dicabut.
- 401
ACCOUNT_BLOCKEDAkun telah diblokir.
- 401
NO_CREDITS_LEFTKredit email tidak cukup untuk semua penerima. Setiap alamat di to, cc, dan bcc memakai 1 kredit.
- 401
USER_NOT_FOUNDPengguna tidak ditemukan.
- 401
MISSING_USER_PRIVILEGESHak akses pengguna tidak cukup.
- 401
EMAIL_CREDITS_NOT_FOUNDGagal mengambil kredit email.
- 401
EMAIL_NOT_VALIDATEDAlamat email akun belum diverifikasi.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI key diblokir sementara karena pelanggaran kebijakan berulang.
- 429
IP_TEMPORARILY_BLOCKEDIP peminta diblokir sementara karena pelanggaran kebijakan berulang.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSTerlalu banyak request bersamaan dari IP ini. Coba lagi sebentar lagi.
- 400
MISSING_QUARANTINE_IDquarantine_id wajib diisi.
- 403
RELEASE_LIMIT_REACHEDTerlalu banyak rilis karantina (batas: 10 / 3 jam). Akun sedang ditinjau.
- 403
QUARANTINE_FORBIDDENData karantina milik akun lain.
- 404
QUARANTINE_NOT_FOUNDData karantina tidak ditemukan atau sudah diproses.
- 410
QUARANTINE_EXPIREDData karantina sudah kedaluwarsa. Silakan kirim ulang email.
- 409
QUARANTINE_ALREADY_APPROVEDEmail ini sudah disetujui tim kami dan sedang dikirim. Tidak perlu tindakan apa pun.
- 409
QUARANTINE_IN_PROGRESSEmail ini sedang dirilis (request lain datang lebih dulu). Tidak perlu tindakan apa pun.
- 500
INTERNAL_SERVER_ERRORError server tak terduga. Coba lagi.
- 500
QUARANTINE_CORRUPTPayload karantina rusak.
- 503
AUTH_UNAVAILABLEAPI key tidak dapat divalidasi saat ini. Coba lagi.