Kirim Lampiran
Lampirkan file ke email apa pun dengan menyertakan array attachments di payload pengiriman. File harus di-encode base64, dan Anda bisa menyertakan beberapa lampiran dalam satu panggilan.
https://mail.sendcorex.com/v3.0/send Lampiran menggunakan endpoint yang sama dengan Kirim Email. Tambahkan array attachments di samping parameter body lainnya.
Parameter lampiran
Setiap item dalam array attachments adalah objek dengan field di bawah ini.
filenamestringwajibNama file yang ditampilkan kepada penerima di aplikasi email mereka.
mis.
"invoice.pdf"contentstringwajibKonten file yang di-encode sebagai string base64.
mis.
"JVBERi0xLjQKJeLjz9MK..."encodingstringwajibEncoding dari content. Harus "base64".
mis.
"base64"
Mulai cepat
import axios from 'axios';
import fs from 'fs';
const fileContent = fs.readFileSync('./invoice.pdf').toString('base64');
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: 'Your Invoice #1042',
body: '<p>Please find your invoice attached.</p>',
attachments: [
{
filename: 'invoice.pdf',
content: fileContent,
encoding: 'base64',
},
],
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
const { id, ids, recipients } = response.data;
console.log('Queued:', id, '| recipients:', recipients);
} catch (err) {
if (err.response?.status === 400 && err.response.data.code === 'DANGEROUS_ATTACHMENT') {
// Attachment blocked for security reasons. There is no quarantine record.
console.log('Blocked:', err.response.data.riskLevel);
} else {
throw err;
}
}Respons
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"ids": [
{ "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
],
"recipients": 1,
"scheduledAt": null
}Lampiran saya diblokir
Untuk melindungi platform kami dan reputasi pengiriman setiap pelanggan, lampiran diperiksa sebelum email masuk antrean. Jika sebuah file dianggap tidak aman, permintaan mengembalikan 400 dengan kode DANGEROUS_ATTACHMENT dan email tidak dikirim.
Lampiran diblokir
{
"error": "One or more attachments were blocked for security reasons.",
"code": "DANGEROUS_ATTACHMENT",
"riskLevel": "high"
}errorPesan yang mudah dibaca yang menjelaskan bahwa sebuah lampiran diblokir.
codeSelalu DANGEROUS_ATTACHMENT untuk respons ini.
riskLevelTingkat risiko yang diberikan pada lampiran yang diblokir. Sertakan saat menghubungi support.
Tidak ada catatan karantina untuk error ini.Berbeda dengan email yang ditandai, lampiran yang diblokir tidak bisa dirilis dengan /quarantine/release. Ini adalah perlindungan yang disengaja terhadap spammer dan pengirim yang menyalahgunakan layanan, sehingga email tidak pernah ditahan untuk dikirim nanti.
Apa yang harus saya lakukan?
Pemeriksaan otomatis kadang bisa menandai file yang sah. Jika Anda perlu mengirim lampiran ini, hubungi tim support kami. Tim kami mengetahui perilaku ini, dan jika pemblokiran ternyata false positive, kami meninjaunya dan menerapkan pembaruan yang diperlukan.
Agar kami bisa menyelesaikannya lebih cepat, sertakan:
- Nama file dan jenis file lampiran
- riskLevel yang dikembalikan oleh API
- Untuk apa file tersebut digunakan di produk Anda
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
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.