Deteksi Realtime

Deteksi realtime menjawab satu pertanyaan tentang satu pengenal, secara langsung: apakah nomor telepon ini — atau alamat email ini — terdaftar di platform tertentu?

Mesinnya sama dengan yang dipakai konsol. Mesin ini menerima nomor telepon atau alamat email, memeriksanya terhadap satu hingga sepuluh produk realtime, dan mengembalikan putusan per produk.

Kapan menggunakannya

Anda punya	Gunakan
Satu pengenal, atau beberapa saja, dan Anda butuh jawabannya sekarang	Realtime
Ribuan pengenal, dan Anda bisa menunggu	Deteksi bulk

Kasus realtime yang umum adalah validasi formulir saat pendaftaran atau checkout, pencarian sekali pakai di dalam alat internal, dan sejumlah kecil pemeriksaan di dalam alur kerja yang sudah berjalan. Bulk dirancang untuk file dan array besar: bersifat asinkron, dihargai per baris yang diperiksa, dan tugas yang selesai dapat diunduh.

Dua seri, satu kontrak

Seri dibawa di dalam path, dan harus sesuai dengan produk yang Anda pilih:

Seri	Endpoint	identifier
Telepon	POST /v1/realtime/check/phone	Nomor E.164, misalnya +8613800138000
Email	POST /v1/realtime/check/email	Alamat email, misalnya user@example.com

Satu permintaan tidak boleh mencampur seri: memilih produk telepon dan produk email dalam panggilan yang sama akan ditolak. country opsional untuk nomor E.164 lengkap, dan harus dihilangkan untuk email.

Bagaimana satu panggilan dihitung

Satu panggilan mengambil satu pengenal dan satu hingga sepuluh produk:

• satu request_id untuk panggilan tersebut
• satu entri per produk di results
• satu tagihan per entri

Karena setiap entri ditagih sendiri-sendiri, satu panggilan bisa berhasil untuk sebagian produk dan gagal untuk yang lain. Hal itu dilaporkan sebagai status: partial_succeeded, dan setiap entri membawa billing_status masing-masing — baca itu, jangan hanya mengandalkan HTTP 200.

Halaman di bagian ini

• Pemeriksaan realtime telepon — endpoint telepon selengkapnya
• Pemeriksaan realtime email — endpoint email selengkapnya
• Produk realtime — daftar produk terkini yang bisa Anda pilih, dan cara membaca ID darinya
• Idempotensi & percobaan ulang — mengapa Idempotency-Key wajib, dan bagaimana perilaku percobaan ulang
• Penagihan & pengembalian dana — apa yang ditagih, apa yang dikembalikan dananya, dan kapan
• Contoh cURL / SDK — panggilan siap salin-tempel untuk kasus umum

Sebelum melakukan panggilan pertama

1. Siapkan API key — lihat Autentikasi.
2. Baca ID produk yang akan Anda pakai dari Produk realtime.
3. Kirim Idempotency-Key yang unik pada setiap panggilan; ini wajib, bukan opsional.