API Pemeriksa Usia & Gender Botim

Periksa registrasi Botim berdasarkan nomor telepon dan dapatkan estimasi AI untuk usia dan jenis kelamin beserta status registrasi untuk setiap nomor yang dikirim. Permudah pengelompokan berdasarkan profil. Tugas ini menggunakan alur kerja batch asinkron standar.

Parameter produk

Parameter	Nilai
Jenis tugas	botim_gender
Jenis input	Nomor telepon format E.164
Minimum entri valid	500

estimated_amount dihitung dari harga akun dan menjadi acuan biaya tugas.

Format input

Unggah file .txt atau .csv dengan satu nomor per baris. Format E.164 disarankan.

+14155552671
+442071838750

Buat tugas

POST https://api.checknumber.ai/v1/tasks

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="botim_gender"'

API mengembalikan ID tugas. Simpan untuk polling status.

Respons unggah

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 500,
  "estimated_amount": {
    "amount": "0.350000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Periksa status tugas

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Polling hingga status menjadi exported. pending dan processing belum selesai.

Respons pemrosesan

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 500,
  "success": 250,
  "failure": 0
}

Respons ekspor

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 500,
  "success": 500,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "0.350000",
    "currency": "USD"
  }
}

Kolom hasil

Kolom	Deskripsi	Contoh
number / Number	Nomor telepon input. CSV memakai number; XLSX memakai Number.	+14155552671
activated	Apakah akun terdeteksi untuk nomor tersebut.	yes / no
gender	Gender yang terdeteksi untuk akun Botim terdaftar.	Male / Female / Unknown
age	Usia atau rentang usia yang terdeteksi untuk akun Botim terdaftar.	25-34

Baris tanpa akun menghasilkan activated=no; kolom profil kosong jika datanya tidak tersedia.

Pemrosesan file hasil

Unduh paket dari result_url hanya setelah diekspor dan pertahankan nama kolom.

Kolom respons

Kolom	Deskripsi
created_at	Waktu pembuatan tugas.
updated_at	Waktu pembaruan terakhir.
task_id	ID tugas unik.
status	pending, processing, exported, atau failed.
total	Total input valid.
success	Nilai yang berhasil diproses.
failure	Nilai yang gagal.
result_url	URL unduhan setelah ekspor.
actual_amount	Biaya akhir jika tersedia.
estimated_amount	Estimasi biaya saat tugas dibuat.

Kode status

Status	Deskripsi
200	Permintaan berhasil.
202	Tugas dibuat dan estimasi biaya diterapkan.
400	File tidak valid, tipe tidak didukung, atau entri kurang dari minimum.
401	API Key hilang atau tidak valid.
402	Saldo tidak cukup.
403	Produk tidak tersedia untuk akun Anda (dihentikan atau hanya untuk pelanggan daftar putih); hubungi dukungan.
404	Tugas tidak ditemukan.
413	File terlalu besar.
500	Kesalahan internal; coba lagi nanti.
503	Produk sementara tidak tersedia (dijeda untuk pemeliharaan); tidak ada biaya yang dikenakan, coba lagi nanti.

Catatan operasional

• Tugas bersifat asinkron; polling dengan ID tugas.
• Hanya nomor valid dan ternormalisasi yang dihitung.
• Tugas gagal dikembalikan dananya sesuai alur penagihan.