Langsung ke konten
Wbiztool

API Verifikasi Nomor

Hasil verifikasi nomor WhatsApp (API)

Baca hasil verifikasi nomor per halaman, difilter berdasarkan tugas atau status. Gunakan untuk mengekspor nomor yang terdaftar di WhatsApp, membersihkan nomor tidak valid dari daftar kontak Anda, atau menyinkronkan hasil ke CRM Anda.

GEThttps://wbiztool.com/api/v1/verification/results/

Tanpa filter, endpoint ini mengembalikan setiap verifikasi di workspace Anda, dari yang terbaru. Termasuk tugas yang dibuat dari halaman dashboard Number verification (Verifikasi nomor), tidak hanya yang dibuat melalui API.

Contoh singkat#

curl "https://wbiztool.com/api/v1/verification/results/?campaign_id=4521&status=verified&limit=100&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parameter request#

Semua parameter dikirim di query string.

Autentikasi

Authorizationheaderwajib

Bearer YOUR_API_KEY, menggunakan key dari Settings → API keys (Pengaturan → Kunci API). Anda dapat mengirim key sebagai parameter query api_key, tetapi header menjaga key tidak tercatat di log server dan proxy.

Filter dan paginasi

campaign_idintegeropsional

Hanya kembalikan nomor dari tugas verifikasi ini. ID ini harus merupakan tugas verifikasi di workspace yang sama dengan API key. Hilangkan untuk mendapatkan hasil dari semua tugas.

statusstringopsional

Hanya kembalikan nomor dengan status ini: pending, verified, atau invalid. Nilai lain diabaikan dan tidak ada filter status yang diterapkan, termasuk unknown, sehingga status=unknown mengembalikan semua status. Nilai peka huruf besar-kecil: Verified diabaikan dan mengembalikan semua status.

limitintegeropsional

Jumlah hasil per halaman. Default 100. Gunakan nilai 1 atau lebih.

offsetintegeropsional

Jumlah hasil yang dilewati. Default 0. Harus 0 atau lebih.

Respons#

Request yang berhasil mengembalikan HTTP 200:

{
  "status": "success",
  "total_count": 2,
  "returned_count": 2,
  "limit": 100,
  "offset": 0,
  "has_more": false,
  "results": [
    {
      "id": 88215,
      "campaign_id": 4521,
      "campaign_name": "Website leads - September",
      "number": "14155550123",
      "status": "verified",
      "checked_at": "2026-09-16T10:16:26.730114+00:00",
      "created_at": "2026-09-16T10:15:00.483101+00:00"
    },
    {
      "id": 88213,
      "campaign_id": 4521,
      "campaign_name": "Website leads - September",
      "number": "919876543210",
      "status": "verified",
      "checked_at": "2026-09-16T10:16:12.204551+00:00",
      "created_at": "2026-09-16T10:15:00.482913+00:00"
    }
  ]
}
FieldTipeDeskripsi
statusstring"success". Error mengembalikan "error".
total_countintegerJumlah hasil yang cocok dengan filter Anda, di semua halaman.
returned_countintegerJumlah hasil dalam respons ini.
limitintegerlimit yang digunakan.
offsetintegeroffset yang digunakan.
has_morebooleantrue jika offset + limit kurang dari total_count, artinya masih ada halaman berikutnya.
resultsarrayHasilnya, dari yang terbaru.
results[].idintegerID data verifikasi ini.
results[].campaign_idinteger atau nullID tugas tempat nomor ini berada.
results[].campaign_namestring atau nullNama tugas tersebut.
results[].numberstringNomor telepon yang sudah dibersihkan.
results[].statusstringpending, verified, invalid, atau unknown untuk pemeriksaan yang dibatalkan.
results[].checked_atstring atau nullWaktu nomor diperiksa, atau null selama masih pending.
results[].created_atstringWaktu nomor ditambahkan.

Timestamp menggunakan ISO 8601 dalam UTC dengan offset +00:00. Untuk arti setiap status, lihat Nilai status nomor.

Error#

Error mengembalikan body JSON dengan status bernilai "error" dan kode error HTTP:

{ "status": "error", "message": "Campaign not found" }
HTTPPesanCara memperbaikinya
405Only GET method allowedKirim request GET.
401API key requiredTambahkan header Authorization: Bearer YOUR_API_KEY.
401Invalid API keyPastikan key tersebut ada dan belum dihapus atau dinonaktifkan.
404Campaign not foundcampaign_id tidak ada, bukan tugas verifikasi, atau milik workspace lain.
500Internal server error: …Biasanya campaign_id, limit, atau offset bukan bilangan bulat, offset bernilai negatif, atau offset + limit bernilai negatif.

Membaca semua halaman#

Tambahkan offset sebesar limit sampai has_more bernilai false.

Ekspor semua nomor terverifikasi dari sebuah tugas
import requests

numbers, offset, limit = [], 0, 500

while True:
    response = requests.get(
        "https://wbiztool.com/api/v1/verification/results/",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        params={"campaign_id": 4521, "status": "verified", "limit": limit, "offset": offset},
        timeout=60,
    )
    result = response.json()
    if result["status"] != "success":
        raise RuntimeError(result["message"])

    numbers += [item["number"] for item in result["results"]]
    if not result["has_more"]:
        break
    offset += limit

print(len(numbers), "numbers are on WhatsApp")

Tips#

  • Hapus duplikat berdasarkan id saat membaca per halaman. Hasil diurutkan berdasarkan waktu pembuatan, dari yang terbaru. Nomor dari tugas yang sama memiliki timestamp yang hampir sama dan verifikasi baru dapat ditambahkan selama Anda membaca halaman, sehingga sebuah baris bisa muncul di dua halaman atau terlewat. Memfilter berdasarkan campaign_id dan menunggu tugas selesai dapat mengurangi hal ini.
  • Tunggu sampai selesai sebelum mengekspor. Periksa Status verifikasi sampai overall_status bernilai completed, atau tangani hasil pending di kode Anda.
  • Bersihkan daftar kontak Anda dengan mengekspor status=invalid dan menghapus nomor-nomor tersebut sebelum kampanye berikutnya.
  • Ukuran halaman: tidak ada limit maksimum, tetapi halaman yang sangat besar menghasilkan respons yang besar dan lambat.