· 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
| Parameter | Tipe | Deskripsi |
|---|---|---|
file | file | File berisi nomor yang akan diperiksa, satu nomor per baris |
task_type | string | ws_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)
| Bidang | Deskripsi | Contoh |
|---|---|---|
Number | Nomor telepon dalam format E.164 | +6281234567890 |
signature | Tanda tangan atau status WhatsApp | ”Hey there! I am using WhatsApp” |
status_update | Waktu pembaruan status terakhir | 2025-01-19 |
whatsapp | Apakah nomor tersebut punya akun aktif | yes, no |
Format Respons API
| Bidang | Deskripsi |
|---|---|
created_at | Stempel waktu pembuatan tugas |
updated_at | Stempel waktu pembaruan terakhir tugas |
task_id | Pengidentifikasi unik tugas |
status | Status tugas: pending/processing/completed/exported |
total | Total jumlah nomor telepon yang diproses |
success | Jumlah nomor yang berhasil diidentifikasi |
failure | Jumlah nomor yang gagal diproses |
result_url | (Opsional) URL unduh hasil ketika status adalah exported |
Kode Status
| Status | Deskripsi |
|---|---|
200 | charge, Permintaan berhasil, tugas dibuat atau status diambil |
400 | free, Permintaan buruk, parameter atau format file tidak valid |
500 | free, Kesalahan server internal, coba lagi nanti |
Catatan Integrasi
- Setiap baris dalam file masukan (input file) harus berisi satu nomor telepon dengan format E.164.
- Pantau status tugas dengan menggunakan
task_idyang diberikan. - Unduh hasil dari
result_urljika status sudah mencapai “exported”. - 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.