Header Kustom
Tambahkan header kustom ke email keluar Anda menggunakan objek headers pada permintaan pengiriman.
https://mail.sendcorex.com/v3.0/sendAturan penamaan:header apa pun di luar daftar yang dicadangkan di bawah harus diawali dengan X-. Aturan ini diterapkan untuk mencegah header injection dan melindungi field yang dicadangkan oleh RFC.
Header yang dicadangkan
Header ini tidak memerlukan prefiks X-. Untuk header berhenti berlangganan, lihatHeader Berhenti Berlangganan.
List-IdMengidentifikasi mailing list tempat email ini berada.
X-Report-AbuseURL tempat penerima bisa melaporkan penyalahgunaan.
Feedback-IDPengenal yang digunakan penyedia mailbox untuk mengelompokkan laporan feedback loop.
List-UnsubscribeMetode berhenti berlangganan (mailto: dan/atau https:).
List-Unsubscribe-PostMengaktifkan berhenti berlangganan sekali klik.
Header lainnya
Harus diawali dengan X-. Selain itu akan ditolak sebelum email masuk antrean.
Valid
"X-MyCustomHeader": "testcustom0""X-CUSTOM-X": "testcustom1"
Tidak valid
"MyCustomHeader": "testcustom0"- →
HEADER_NOT_ALLOWED
Mulai cepat
import axios from 'axios';
await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'user@example.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Welcome aboard!',
body: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
replyTo: 'support@yourdomain.com',
headers: {
'List-Id': 'My List <mylist.yourdomain.com>',
'X-Report-Abuse': 'https://yourdomain.com/report-abuse',
'Feedback-ID': 'campaign123:subscriber456:list789:youraccount',
'List-Unsubscribe':
'<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>',
'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
'X-MyCustomHeader': 'testcustom0',
'X-CUSTOM-X': 'testcustom1',
},
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);Respons
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"
}Error
Semua kode error →Error mengembalikan objek JSON dengan error, code, dan responseTime.
- 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
DOMAIN_NOT_VALIDATEDDomain pengirim belum diverifikasi.
- 401
LISTED_SPAM_HAUSDomain pengirim terdaftar di Spamhaus.
- 401
ISP_DOMAIN_BLOCKEDMengirim dari domain umum (gmail.com, outlook.com, dll.) tidak diizinkan.
- 401
FROM_HEADER_DOMAIN_MISMATCHDomain header From tidak diizinkan untuk pengirim ini.
- 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
INVALID_JSONBody request bukan JSON yang valid.
- 400
MISSING_FROMField from tidak ada atau kosong.
- 400
INVALID_FROM_FORMATField from harus berupa alamat email yang valid.
- 400
MISSING_SENDERNAMEField senderName tidak ada atau kosong.
- 400
INVALID_SENDERNAME_FORMATField senderName berisi karakter yang tidak valid.
- 400
MISSING_SUBJECTField subject tidak ada atau kosong.
- 400
MISSING_BODYField body tidak ada atau kosong.
- 400
MISSING_TOADDRESSField to tidak ada atau kosong.
- 400
MISSING_TOField to tidak ada atau kosong.
- 400
INVALID_TOADDRESSSatu atau lebih alamat penerima tidak valid.
- 400
TOADDRESS_LIMIT_EXCEEDEDLebih dari 50 penerima di array to.
- 400
INVALID_CCADDRESSSatu atau lebih alamat cc tidak valid.
- 400
INVALID_BCCADDRESSSatu atau lebih alamat bcc tidak valid.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc, dan bcc jika digabung memiliki lebih dari 50 penerima unik.
- 400
INVALID_SCHEDULED_ATscheduled_at bukan tanggal yang valid atau sudah lewat.
- 400
INVALID_SENDER_FORMATFormat email pengirim tidak valid.
- 400
HEADER_NOT_ALLOWEDKunci header kustom tidak ada di daftar yang diizinkan (List-Unsubscribe, List-Id, X-*, dll.).
- 400
INVALID_HEADER_VALUENilai header berisi karakter tidak valid (CR/LF tidak diizinkan).
- 400
DANGEROUS_ATTACHMENTSatu atau lebih lampiran diblokir demi keamanan.
- 400
INVALID_ATTACHMENTKonten lampiran bukan base64 yang valid.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe bernilai true tetapi body tidak memiliki placeholder berhenti berlangganan ([unsubscribe_url], [unsubscribe], [unsub_url], atau [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDAkun dibatasi sementara.
- 403
DAILY_LIMITBatas harian pengiriman email tercapai.
- 403
MARKETING_LIMIT_REACHEDBatas harian email marketing paket gratis tercapai: 30 email marketing atau cold outreach per hari, dihitung per penerima dalam jendela bergulir 24 jam. Respons berisi limit, used, recipients, dan upgradeUrl. Email transaksional tetap terkirim; tidak ada yang diantrekan.
- 403
FORBIDDEN_HTML_CONTENTHTML berisi konten aktif yang tidak diizinkan di email (script, iframe, form, input, button, embed, object, svg, handler on*, link javascript:, meta refresh…). Respons mencantumkan temuannya. Gunakan <a> yang diberi gaya sebagai pengganti tombol atau formulir.
- 403
SPAM_DETECTEDKonten email ditandai sebagai spam. Respons menyertakan quarantine_id dan petunjuk rilis.
- 403
SENDER_NAME_MISMATCHTerdeteksi beberapa nama pengirim untuk alamat yang sama.
- 403
FOLLOWUP_PATTERN_DETECTEDKonten email ditandai sebagai pola tindak lanjut mencurigakan yang berulang.
- 403
SCAM_PATTERN_DETECTEDKonten email ditandai sebagai pola penipuan.
- 403
ACCOUNT_SUSPENDED_SPOOFINGAkun ditangguhkan karena berulang kali mencoba memalsukan header From.
- 409
IDEMPOTENCY_IN_PROGRESSPermintaan dengan Idempotency-Key yang sama masih diproses. Tunggu (Retry-After: 1) lalu ulangi dengan kunci yang sama.
- 422
IDEMPOTENCY_KEY_REUSEDIdempotency-Key ini sudah dipakai dengan body yang berbeda. Gunakan kunci baru untuk setiap email baru.
- 500
INTERNAL_SERVER_ERRORError server tak terduga. Coba lagi.
- 500
PARSE_ERRORGagal memproses konten email (gagal parse MIME).
- 500
PERSIST_FAILEDGagal memasukkan email ke antrean (gagal menyimpan ke database).
- 503
AUTH_UNAVAILABLEAPI key tidak dapat divalidasi saat ini. Coba lagi.
- 503
UNSUBSCRIBE_UNAVAILABLELayanan tautan berhenti berlangganan sementara tidak tersedia. Coba lagi nanti.