Email

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.

POSThttps://mail.sendcorex.com/v3.0/send
i

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.

  • filenamestringwajib

    Nama file yang ditampilkan kepada penerima di aplikasi email mereka.

    mis. "invoice.pdf"

  • contentstringwajib

    Konten file yang di-encode sebagai string base64.

    mis. "JVBERi0xLjQKJeLjz9MK..."

  • encodingstringwajib

    Encoding 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.

400

Lampiran diblokir

{
  "error": "One or more attachments were blocked for security reasons.",
  "code": "DANGEROUS_ATTACHMENT",
  "riskLevel": "high"
}
  • error

    Pesan yang mudah dibaca yang menjelaskan bahwa sebuah lampiran diblokir.

  • code

    Selalu DANGEROUS_ATTACHMENT untuk respons ini.

  • riskLevel

    Tingkat 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
Hubungi support →

Error mengembalikan objek JSON dengan error dan code.

  • 401MISSING_AUTH_HEADER

    Tidak ada header Authorization.

  • 401INVALID_API_KEY

    API key tidak valid atau sudah dicabut.

  • 401ACCOUNT_BLOCKED

    Akun telah diblokir.

  • 401NO_CREDITS_LEFT

    Kredit email tidak cukup untuk semua penerima. Setiap alamat di to, cc, dan bcc memakai 1 kredit.

  • 401DOMAIN_NOT_VALIDATED

    Domain pengirim belum diverifikasi.

  • 401LISTED_SPAM_HAUS

    Domain pengirim terdaftar di Spamhaus.

  • 401ISP_DOMAIN_BLOCKED

    Mengirim dari domain umum (gmail.com, outlook.com, dll.) tidak diizinkan.

  • 401FROM_HEADER_DOMAIN_MISMATCH

    Domain header From tidak diizinkan untuk pengirim ini.

  • 401USER_NOT_FOUND

    Pengguna tidak ditemukan.

  • 401MISSING_USER_PRIVILEGES

    Hak akses pengguna tidak cukup.

  • 401EMAIL_CREDITS_NOT_FOUND

    Gagal mengambil kredit email.

  • 401EMAIL_NOT_VALIDATED

    Alamat email akun belum diverifikasi.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    API key diblokir sementara karena pelanggaran kebijakan berulang.

  • 429IP_TEMPORARILY_BLOCKED

    IP peminta diblokir sementara karena pelanggaran kebijakan berulang.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Terlalu banyak request bersamaan dari IP ini. Coba lagi sebentar lagi.

  • 400INVALID_JSON

    Body request bukan JSON yang valid.

  • 400MISSING_FROM

    Field from tidak ada atau kosong.

  • 400INVALID_FROM_FORMAT

    Field from harus berupa alamat email yang valid.

  • 400MISSING_SENDERNAME

    Field senderName tidak ada atau kosong.

  • 400INVALID_SENDERNAME_FORMAT

    Field senderName berisi karakter yang tidak valid.

  • 400MISSING_SUBJECT

    Field subject tidak ada atau kosong.

  • 400MISSING_BODY

    Field body tidak ada atau kosong.

  • 400MISSING_TOADDRESS

    Field to tidak ada atau kosong.

  • 400MISSING_TO

    Field to tidak ada atau kosong.

  • 400INVALID_TOADDRESS

    Satu atau lebih alamat penerima tidak valid.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Lebih dari 50 penerima di array to.

  • 400INVALID_CCADDRESS

    Satu atau lebih alamat cc tidak valid.

  • 400INVALID_BCCADDRESS

    Satu atau lebih alamat bcc tidak valid.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc, dan bcc jika digabung memiliki lebih dari 50 penerima unik.

  • 400INVALID_SCHEDULED_AT

    scheduled_at bukan tanggal yang valid atau sudah lewat.

  • 400INVALID_SENDER_FORMAT

    Format email pengirim tidak valid.

  • 400HEADER_NOT_ALLOWED

    Kunci header kustom tidak ada di daftar yang diizinkan (List-Unsubscribe, List-Id, X-*, dll.).

  • 400INVALID_HEADER_VALUE

    Nilai header berisi karakter tidak valid (CR/LF tidak diizinkan).

  • 400DANGEROUS_ATTACHMENT

    Satu atau lebih lampiran diblokir demi keamanan.

  • 400INVALID_ATTACHMENT

    Konten lampiran bukan base64 yang valid.

  • 400MISSING_UNSUBSCRIBE_PLACEHOLDER

    unsubscribe bernilai true tetapi body tidak memiliki placeholder berhenti berlangganan ([unsubscribe_url], [unsubscribe], [unsub_url], atau [opt_out_url]).

  • 403ACCOUNT_RESTRICTED

    Akun dibatasi sementara.

  • 403DAILY_LIMIT

    Batas harian pengiriman email tercapai.

  • 403MARKETING_LIMIT_REACHED

    Batas 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.

  • 403FORBIDDEN_HTML_CONTENT

    HTML 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.

  • 403SPAM_DETECTED

    Konten email ditandai sebagai spam. Respons menyertakan quarantine_id dan petunjuk rilis.

  • 403SENDER_NAME_MISMATCH

    Terdeteksi beberapa nama pengirim untuk alamat yang sama.

  • 403FOLLOWUP_PATTERN_DETECTED

    Konten email ditandai sebagai pola tindak lanjut mencurigakan yang berulang.

  • 403SCAM_PATTERN_DETECTED

    Konten email ditandai sebagai pola penipuan.

  • 403ACCOUNT_SUSPENDED_SPOOFING

    Akun ditangguhkan karena berulang kali mencoba memalsukan header From.

  • 409IDEMPOTENCY_IN_PROGRESS

    Permintaan dengan Idempotency-Key yang sama masih diproses. Tunggu (Retry-After: 1) lalu ulangi dengan kunci yang sama.

  • 422IDEMPOTENCY_KEY_REUSED

    Idempotency-Key ini sudah dipakai dengan body yang berbeda. Gunakan kunci baru untuk setiap email baru.

  • 500INTERNAL_SERVER_ERROR

    Error server tak terduga. Coba lagi.

  • 500PARSE_ERROR

    Gagal memproses konten email (gagal parse MIME).

  • 500PERSIST_FAILED

    Gagal memasukkan email ke antrean (gagal menyimpan ke database).

  • 503AUTH_UNAVAILABLE

    API key tidak dapat divalidasi saat ini. Coba lagi.

  • 503UNSUBSCRIBE_UNAVAILABLE

    Layanan tautan berhenti berlangganan sementara tidak tersedia. Coba lagi nanti.