· 3 min read

API Pengecek Nomor WhatsApp Massal Detail (Details API)

Cek apakah nomor telepon global ada di WhatsApp dan dapatkan informasi profil terperinci termasuk tanda tangan (signatures) dan pembaruan status.

Cek apakah nomor telepon global adalah akun WhatsApp terdaftar dan dapatkan informasi profil terperinci.

URL API

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

Fitur Utama

API Pengecek Nomor WhatsApp Massal Detail menawarkan kemampuan verifikasi komprehensif:

Informasi Akun

Informasi akun WhatsApp terperinci termasuk:

  • Verifikasi status akun
  • Tanda tangan (Signature) pengguna
  • Stempel waktu pembaruan status terakhir

Pemrosesan Massal

Proses beberapa nomor secara bersamaan melalui pengunggahan file, membuatnya efisien untuk verifikasi skala besar.

Pembaruan Status Real-time

Pantau kemajuan tugas verifikasi massal Anda dengan pembaruan status secara waktu nyata.

Langkah-langkah Penggunaan

Pengunggahan File

Unggah file teks berisi nomor telepon dalam format E.164:

Contoh Permintaan

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"/path/to/file"' \
--form 'task_type="ws_active"'

Parameter Permintaan

ParameterTipeDeskripsi
filefileFile berisi nomor yang akan diperiksa, satu nomor per baris
task_typestringws_active — aktivitas / tanda tangan

Pengecekan Status

Pantau status pemrosesan tugas Anda:

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

Contoh Respons

Respons Pembuatan Tugas

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Respons Status Pemrosesan

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Respons Tugas Selesai

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

Bidang Hasil (Result Fields)

BidangDeskripsiContoh
NumberNomor telepon dalam format E.164+6281234567890
signatureTanda tangan atau status WhatsApp”Hey there! I am using WhatsApp”
status_updateWaktu pembaruan status terakhir2025-01-19
whatsappApakah nomor tersebut punya akun aktifyes, no

Format Respons API

BidangDeskripsi
created_atStempel waktu pembuatan tugas
updated_atStempel waktu pembaruan terakhir tugas
task_idPengidentifikasi unik tugas
statusStatus tugas: pending/processing/completed/exported
totalTotal jumlah nomor telepon yang diproses
successJumlah nomor yang berhasil diidentifikasi
failureJumlah nomor yang gagal diproses
result_url(Opsional) URL unduh hasil ketika status adalah exported

Kode Status

StatusDeskripsi
200charge, Permintaan berhasil, tugas dibuat atau status diambil
400free, Permintaan buruk, parameter atau format file tidak valid
500free, Kesalahan server internal, coba lagi nanti

Catatan Integrasi

  1. Setiap baris dalam file masukan (input file) harus berisi satu nomor telepon dengan format E.164.
  2. Pantau status tugas dengan menggunakan task_id yang diberikan.
  3. Unduh hasil dari result_url jika status sudah mencapai “exported”.
  4. Tangani berbagai kode status (status codes) secara tepat di aplikasi Anda.

FAQ

1. Berapa kapasitas pemrosesan dari API ini?

API ini dapat memproses nomor dalam jumlah besar secara efisien, dengan update status real-time saat berjalan.

2. Format apa yang harus digunakan untuk file masukan?

File masukan sebaiknya berupa file teks (text file) yang berisi satu nomor per baris berformat E.164 (misalnya: +6281234567890).

3. Informasi apa saja yang dikembalikan API ini?

API mengembalikan informasi akun terperinci termasuk:

  • Status akun WhatsApp (aktif/tidak)
  • Tanda tangan (Signature) pengguna
  • Waktu (timestamp) pembaruan status terakhir
4. Berapa harga untuk API Detail ini?

Harganya adalah $2 USD per 10.000 nomor untuk informasi akun WhatsApp detail termasuk waktu pembaruan dan tanda tangan (signatures).

Untuk informasi lebih lanjut tentang harga dan pemrosesan dalam volume yang lebih tinggi, silakan hubungi kami.

Related Posts

View All Posts »