Pemeriksaan Realtime Email

POST/v1/realtime/check/email

Periksa satu alamat email secara sinkron terhadap satu hingga sepuluh produk email realtime. Mesin, kontrak penagihan, dan bentuk responsnya identik dengan endpoint telepon; hanya seri dan format pengenalnya yang berbeda.

Parameter

Field	Tipe	Wajib	Deskripsi
identifier	string	Ya	Satu alamat email, misalnya user@example.com.
country	string	Tidak	Harus dihilangkan untuk email. Mengirim kode negara bersama produk email akan ditolak.
product_ids	array<int>	Ya	Array berisi 1 hingga 10 ID produk email realtime.

Country harus kosong

Email tidak memiliki dimensi negara. country opsional pada endpoint telepon tetapi tidak diterima di sini — permintaan yang membawanya akan gagal validasi sebelum apa pun dikirim atau ditagih.

Idempotensi wajib

Idempotency-Key wajib pada setiap panggilan. Mencoba ulang permintaan yang sama dengan key yang sama tidak menagih dua kali; mengubah payload akan mengembalikan 409. Lihat Idempotensi & percobaan ulang.

Memilih produk

Produk email dan telepon adalah seri yang berbeda dan tidak dapat digabungkan dalam satu permintaan. Baca id entri yang mode-nya realtime dan serinya email dari Produk realtime, yang bersumber dari GET /v1/products. Mengirim slug tidak pernah berhasil di sini, dan ID produk telepon dalam panggilan email akan ditolak sebagai seri yang tidak cocok.

Contoh Respons

{
  "request_id": "b7d2a1c4-9f3e-4a1b-8c5d-2e6f7a8b9c0d",
  "identifier": "user@example.com",
  "series": "email",
  "status": "succeeded",
  "request_status": "completed",
  "replayed": false,
  "total_reserved": 0.004000,
  "total_charged": 0.004000,
  "total_refunded": 0.000000,
  "results": [
    {
      "product_id": 49,
      "product": "insemailvalid-rt",
      "result": "valid",
      "cached": false,
      "billing_status": "charged",
      "charged_amount": 0.002000,
      "refunded_amount": 0.000000,
      "checked_at": "2026-09-13T10:00:00Z",
      "error_code": null
    }
  ]
}

Nilai product_id di atas hanyalah contoh — pastikan ID produk email terkini di Produk realtime sebelum mengirim permintaan sungguhan. request_id adalah UUID, dan cached berada di dalam tiap hasil, bukan di tingkat atas.

Contoh cURL

curl -X POST "https://api.zelnum.com/api/v1/realtime/check/email" \
  -H "X-API-Key: YOUR_KEY_HERE" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"user@example.com","product_ids":[49]}'

Error khusus email

HTTP	code	Arti
400	invalid_realtime_request	Alamatnya tidak valid, country ikut dikirim, ID-nya milik seri lain, atau tidak ada ID yang diberikan. Tidak ada yang dikirim dan tidak ada yang ditagih.
400	idempotency_key_required	Header Idempotency-Key tidak ada.
402	insufficient_balance	Saldo tidak mencukupi reservasi; tidak ada item yang dimulai.
409	request_in_progress / idempotency_conflict	Key sama, masih berjalan, atau key sama dengan payload berbeda.

Kode status lainnya — 401, 403, 429, 503, 500 — berperilaku persis seperti yang didokumentasikan pada endpoint telepon.