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.

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

Tidak dikirim: email yang dikarantina tidak dikirim. Gunakan /quarantine/release untuk mengirimnya setelah ditinjau. Catatan kedaluwarsa setelah 3 jam.

Cara kerja

  1. 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. 2

    Terima 403

    Responsnya adalah 403 Forbidden dengan kode SPAM_DETECTED, sebuah detectionId, dan sebuah quarantine_id.

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

  • errorstring

    Pesan yang mudah dibaca yang menjelaskan bahwa konten ditandai sebagai spam.

    mis. "Email content flagged as spam."

  • codestring

    Kode error yang bisa dibaca mesin. Selalu SPAM_DETECTED untuk email yang ditandai.

    mis. "SPAM_DETECTED"

  • detectionIdstring

    ID unik deteksi spam. Sertakan saat menghubungi support.

    mis. "det_8c1e5a92b7d04f36"

  • quarantine_idstring | null

    ID 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 | null

    Petunjuk singkat cara merilis email. null jika tidak ada quarantine_id.

    mis. "POST /v3.0/quarantine/release with { quarantine_id }"

  • expires_instring | null

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

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

  • 400MISSING_QUARANTINE_ID

    quarantine_id wajib diisi.

  • 403RELEASE_LIMIT_REACHED

    Terlalu banyak rilis karantina (batas: 10 / 3 jam). Akun sedang ditinjau.

  • 403QUARANTINE_FORBIDDEN

    Data karantina milik akun lain.

  • 404QUARANTINE_NOT_FOUND

    Data karantina tidak ditemukan atau sudah diproses.

  • 410QUARANTINE_EXPIRED

    Data karantina sudah kedaluwarsa. Silakan kirim ulang email.

  • 409QUARANTINE_ALREADY_APPROVED

    Email ini sudah disetujui tim kami dan sedang dikirim. Tidak perlu tindakan apa pun.

  • 409QUARANTINE_IN_PROGRESS

    Email ini sedang dirilis (request lain datang lebih dulu). Tidak perlu tindakan apa pun.

  • 500INTERNAL_SERVER_ERROR

    Error server tak terduga. Coba lagi.

  • 500QUARANTINE_CORRUPT

    Payload karantina rusak.

  • 503AUTH_UNAVAILABLE

    API key tidak dapat divalidasi saat ini. Coba lagi.