Langkau ke kandungan
Wbiztool

API pengesahan nombor

Keputusan pengesahan nombor WhatsApp (API)

Baca keputusan pengesahan nombor halaman demi halaman, ditapis mengikut tugas atau status. Gunakannya untuk mengeksport nombor yang menggunakan WhatsApp, membuang nombor tidak sah daripada senarai kenalan anda atau menyegerakkan keputusan ke dalam CRM anda.

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

Tanpa penapis, ia memulangkan setiap pengesahan dalam ruang kerja anda, yang terbaharu dahulu. Ini termasuk tugas yang dicipta dari halaman papan pemuka Number verification (Pengesahan nombor), bukan hanya yang dicipta melalui API.

Contoh ringkas#

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

Parameter permintaan#

Semua parameter diletakkan dalam rentetan pertanyaan.

Pengesahan identiti

Authorizationheaderwajib

Bearer YOUR_API_KEY, menggunakan kunci dari Settings → API keys (Tetapan → Kunci API). Anda boleh menghantar kunci sebagai parameter pertanyaan api_key, tetapi pengepala menghalangnya daripada muncul dalam log pelayan dan proksi.

Penapis dan penomboran halaman

campaign_idintegerpilihan

Pulangkan hanya nombor daripada tugas pengesahan ini. Ia mesti tugas pengesahan dalam ruang kerja yang sama dengan kunci API. Jangan sertakannya untuk mendapatkan keputusan daripada semua tugas.

statusstringpilihan

Pulangkan hanya nombor dengan status ini: pending, verified atau invalid. Sebarang nilai lain diabaikan dan tiada penapis status digunakan, termasuk unknown, jadi status=unknown memulangkan setiap status. Nilai adalah sensitif huruf besar/kecil: Verified diabaikan dan memulangkan setiap status.

limitintegerpilihan

Bilangan keputusan setiap halaman. Lalai 100. Gunakan nilai 1 atau lebih.

offsetintegerpilihan

Bilangan keputusan yang dilangkau. Lalai 0. Mesti 0 atau lebih.

Respons#

Permintaan yang berjaya memulangkan 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"
    }
  ]
}
MedanJenisPenerangan
statusstring"success". Ralat memulangkan "error".
total_countintegerKeputusan yang sepadan dengan penapis anda, merentasi semua halaman.
returned_countintegerKeputusan dalam respons ini.
limitintegerlimit yang digunakan.
offsetintegeroffset yang digunakan.
has_morebooleantrue jika offset + limit kurang daripada total_count, bermaksud ada halaman lain.
resultstatasusunanKeputusan, yang terbaharu dahulu.
results[].idintegerID rekod pengesahan ini.
results[].campaign_idinteger atau nullID tugas yang memiliki nombor itu.
results[].campaign_namestring atau nullNama tugas tersebut.
results[].numberstringNombor telefon yang telah dibersihkan.
results[].statusstringpending, verified, invalid, atau unknown untuk semakan yang dibatalkan.
results[].checked_atstring atau nullMasa nombor disemak, atau null semasa ia masih menunggu.
results[].created_atstringMasa nombor ditambah.

Cap masa dalam ISO 8601 dalam UTC dengan ofset +00:00. Untuk maksud setiap status, lihat Nilai status nombor.

Ralat#

Ralat memulangkan badan JSON dengan status ditetapkan kepada "error" dan kod ralat HTTP:

{ "status": "error", "message": "Campaign not found" }
HTTPMesejCara membetulkannya
405Only GET method allowedHantar permintaan GET.
401API key requiredTambah pengepala Authorization: Bearer YOUR_API_KEY.
401Invalid API keyPastikan kunci wujud dan belum dipadam atau dinyahdayakan.
404Campaign not foundcampaign_id tidak wujud, bukan tugas pengesahan, atau milik ruang kerja lain.
500Internal server error: …Biasanya campaign_id, limit atau offset bukan nombor bulat, offset negatif, atau offset + limit negatif.

Membaca setiap halaman#

Tambah offset sebanyak limit sehingga has_more ialah false.

Eksport semua nombor yang disahkan daripada satu 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")

Petua#

  • Buang pendua mengikut id semasa membaca halaman. Keputusan diisih mengikut masa penciptaan, yang terbaharu dahulu. Nombor daripada tugas yang sama berkongsi cap masa yang hampir sama dan pengesahan baharu boleh ditambah semasa anda membaca halaman, jadi satu baris boleh muncul pada dua halaman atau terlangkau. Menapis mengikut campaign_id dan menunggu tugas selesai mengurangkan masalah ini.
  • Tunggu sehingga selesai sebelum mengeksport. Semak Status pengesahan sehingga overall_status ialah completed, atau kendalikan keputusan pending dalam kod anda.
  • Bersihkan senarai kenalan anda dengan mengeksport status=invalid dan membuang nombor tersebut sebelum kempen seterusnya.
  • Saiz halaman: tiada had maksimum untuk limit, tetapi halaman yang sangat besar menghasilkan respons yang besar dan perlahan.