Kirim Pemeriksaan (Unggah Berkas)

POST/v1/detect/file

Unggah berkas TXT atau CSV dengan satu nomor per baris, maks 50 MB.

HTTP 202 Accepted

Parameter

Content-Type: multipart/form-data

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
file	file	Ya	Berkas TXT atau CSV, satu nomor per baris, maks 50 MB.

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": "qH5rZ7Lp3Wm9",
  "idempotent_replay": false,
  "message": "File queued (10000 numbers). Poll GET /api/v1/tasks/qH5rZ7Lp3Wm9 for progress.",
  "recovery_pending": false,
  "summary": {
    "total": 10000,
    "cost_deducted": 1.000000
  }
}

Bidang Respons

Kirim Pemeriksaan (Nomor)