Kirim Pemeriksaan (Array)

POST/v1/detect

Kirim array nomor telepon untuk pemeriksaan. Diproses secara asinkron. Biaya dipotong di muka; nomor yang tidak diperiksa dikembalikan otomatis.

HTTP 202 Accepted

Parameter

Field	Tipe	Wajib	Deskripsi
product	string	Ya	Slug produk — Daftar Produk
country	string	Wajib untuk telepon	Produk telepon: kode ISO 3166-1 alpha-2, misalnya CN atau US. Produk email: hilangkan bidang ini sepenuhnya. — Kode Negara
phones	array	Ya	Array berisi nomor telepon atau alamat email dari satu seri.

Catatan

Pengiriman harus memenuhi minimum produk yang dipilih — 500, 1,000 atau 2,000 bergantung pada produknya, dan ditampilkan di daftar produk massal — serta tetap di bawah maksimum platform 2,000,000. Pengiriman di bawah minimum ditolak sebagai too_few_numbers.

Country hanya ada pada produk telepon

Email tidak memiliki dimensi negara. Mengirim country bersama produk email akan gagal validasi. Ini cerminan dari endpoint realtime, tempat country bersifat opsional tetapi harus dihilangkan untuk email.

Contoh Respons

{
  "mode": "async",
  "task_id": "xKj9aP3qLm7v",
  "idempotent_replay": false,
  "message": "Task queued. Poll GET /api/v1/tasks/xKj9aP3qLm7v for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 5000,
    "cost_deducted": 0.500000
  }
}

Bidang Respons

Field	Tipe	Deskripsi
mode	string	Selalu async untuk pengiriman massal.
task_id	string	Token yang Anda pakai untuk polling dan mengunduh. Ini adalah parameter path {token} pada endpoint tugas.
idempotent_replay	boolean	true jika pengiriman memakai ulang tugas sebelumnya alih-alih membuat tugas baru.
recovery_pending	boolean	true jika tugas berada dalam antrean tetapi penghitungannya masih direkonsiliasi.
message	string	Langkah berikutnya yang mudah dibaca manusia.
summary.total	integer	Baris yang diterima.
summary.cost_deducted	number	Jumlah yang dipotong di muka untuk pengiriman.

Berikutnya

• Kirim file alih-alih array
• Poll status tugas sampai pekerjaan selesai