Karantina

Rilis Email

Merilis email yang dikarantina untuk dikirim. Body dan subjek disanitasi sebelum dikirim. Setiap quarantine_id hanya bisa dirilis sekali.

POSThttps://mail.sendcorex.com/v3.0/quarantine/release
i

Dari mana ID-nya berasal? Saat /send menandai sebuah pesan, endpoint ini mengembalikan 403 dengan quarantine_id. LihatPesan saya ditandai sebagai spam.

!

Batasan:catatan karantina kedaluwarsa setelah 3 jam, dan rilis dibatasi 10 per 3 jam. Melebihi batas ini mengembalikan RELEASE_LIMIT_REACHED dan akun akan ditinjau. Tinjau konten sebelum merilis.

Parameter body

  • quarantine_idstringwajib

    ID yang dikembalikan dalam respons 403 dari /send saat email ditandai.

    mis. "qtn_3f2a1b4c8e9d4f7a"

Apa yang terjadi saat rilis

  1. 1

    Pencarian

    Catatan karantina diambil dan divalidasi terhadap akun Anda. Catatan milik akun lain ditolak.

  2. 2

    Sanitasi

    Body dan subjek disanitasi untuk menghapus pola berbahaya yang tersisa sebelum dikirim.

  3. 3

    Ingest

    Setiap penerima dalam payload asli mendapat catatan email tersendiri yang disiapkan dan dikirim melalui pipeline ingest internal.

  4. 4

    Tandai sebagai dirilis

    Catatan karantina ditandai sebagai released: true dan penghitung rilis bertambah. Panggilan berikutnya dengan ID yang sama ditolak.

Karena body dan subjek disanitasi, email yang dikirim bisa berbeda dari yang Anda kirim semula.

Mulai cepat

import axios from 'axios';

const quarantineId = 'qtn_3f2a1b4c8e9d4f7a';

const response = await axios.post(
  'https://mail.sendcorex.com/v3.0/quarantine/release',
  { quarantine_id: quarantineId },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);

const { success, released, recipients } = response.data;
console.log(`Released to ${recipients} recipient(s)`);

Respons

{
  "success": true,
  "released": true,
  "code": "QUARANTINE_RELEASED",
  "quarantine_id": "qtn_3f2a1b4c8e9d4f7a",
  "recipients": 1
}

Error mengembalikan objek JSON dengan error, code, dan responseTime.

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