İçeriğe geç
Wbiztool

Numara doğrulama API'si

WhatsApp numara doğrulama sonuçları (API)

Numara doğrulama sonuçlarını göreve veya duruma göre filtreleyerek sayfa sayfa okuyun. WhatsApp'ta olan numaraları dışa aktarmak, geçersiz numaraları kişi listenizden temizlemek veya sonuçları CRM'inizle eşitlemek için kullanın.

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

Filtre olmadan, çalışma alanınızdaki her doğrulamayı en yeniden başlayarak döndürür. Buna yalnızca API ile oluşturulan görevler değil, Numara doğrulama panel sayfasından oluşturulan görevler de dahildir.

Hızlı örnek#

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

İstek parametreleri#

Tüm parametreler sorgu dizesinde gönderilir.

Kimlik doğrulama

Authorizationheaderzorunlu

Ayarlar → API anahtarları sayfasındaki bir anahtarla Bearer YOUR_API_KEY. Anahtarı bunun yerine api_key sorgu parametresi olarak da iletebilirsiniz, ancak başlık kullanmak anahtarı sunucu ve proxy günlüklerinin dışında tutar.

Filtreler ve sayfalama

campaign_idintegeristeğe bağlı

Yalnızca bu doğrulama görevindeki numaraları döndürür. API anahtarıyla aynı çalışma alanındaki bir doğrulama görevi olmalıdır. Tüm görevlerin sonuçlarını almak için göndermeyin.

statusstringisteğe bağlı

Yalnızca bu durumdaki numaraları döndürür: pending, verified veya invalid. Diğer her değer, unknown dahil, yok sayılır ve durum filtresi uygulanmaz; yani status=unknown her durumu döndürür. Değerler büyük/küçük harfe duyarlıdır: Verified yok sayılır ve her durumu döndürür.

limitintegeristeğe bağlı

Sayfa başına sonuç. Varsayılan 100. 1 veya daha büyük bir değer kullanın.

offsetintegeristeğe bağlı

Atlanacak sonuç sayısı. Varsayılan 0. 0 veya daha büyük olmalıdır.

Yanıt#

Başarılı bir istek HTTP 200 döndürür:

{
  "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"
    }
  ]
}
AlanTürAçıklama
statusstring"success". Hatalar "error" döndürür.
total_countintegerTüm sayfalarda filtrelerinizle eşleşen sonuçlar.
returned_countintegerBu yanıttaki sonuçlar.
limitintegerKullanılan limit.
offsetintegerKullanılan offset.
has_morebooleanoffset + limit değeri total_count değerinden küçükse, yani başka bir sayfa varsa true.
resultsdiziSonuçlar, en yeniden başlayarak.
results[].idintegerBu doğrulama kaydının ID'si.
results[].campaign_idinteger veya nullNumaranın ait olduğu görevin ID'si.
results[].campaign_namestring veya nullO görevin adı.
results[].numberstringTemizlenmiş telefon numarası.
results[].statusstringpending, verified, invalid veya iptal edilmiş bir kontrol için unknown.
results[].checked_atstring veya nullNumaranın kontrol edildiği zaman; beklemedeyken null.
results[].created_atstringNumaranın eklendiği zaman.

Zaman damgaları +00:00 farkıyla UTC'de ISO 8601 biçimindedir. Her durumun ne anlama geldiği için Numara durumu değerleri bölümüne bakın.

Hatalar#

Hatalar, status değeri "error" olan bir JSON gövdesi ve bir HTTP hata kodu döndürür:

{ "status": "error", "message": "Campaign not found" }
HTTPMesajNasıl düzeltilir
405Only GET method allowedBir GET isteği gönderin.
401API key requiredAuthorization: Bearer YOUR_API_KEY başlığını ekleyin.
401Invalid API keyAnahtarın mevcut olduğunu ve silinmediğini veya devre dışı bırakılmadığını kontrol edin.
404Campaign not foundcampaign_id mevcut değil, bir doğrulama görevi değil veya başka bir çalışma alanına ait.
500Internal server error: …Genellikle campaign_id, limit veya offset bir tam sayı değildir, offset negatiftir ya da offset + limit negatiftir.

Her sayfayı okuma#

has_more değeri false olana kadar offset değerini limit kadar artırın.

Bir görevdeki tüm doğrulanmış numaraları dışa aktarma
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")

İpuçları#

  • Sayfalarken id değerine göre tekrarları ayıklayın. Sonuçlar oluşturulma zamanına göre, en yeniden başlayarak sıralanır. Aynı görevdeki numaraların zaman damgaları neredeyse aynıdır ve siz sayfalarken yeni doğrulamalar eklenebilir; bu yüzden bir satır iki sayfada görünebilir veya atlanabilir. campaign_id ile filtrelemek ve görevin bitmesini beklemek bunu azaltır.
  • Tamamlanmasını bekleyin: dışa aktarmadan önce overall_status değeri completed olana kadar Doğrulama durumu ile kontrol edin veya kodunuzda pending sonuçları ele alın.
  • Kişi listenizi temizleyin: bir sonraki kampanyanızdan önce status=invalid sonuçlarını dışa aktarın ve bu numaraları kaldırın.
  • Sayfa boyutu: en büyük limit değeri yoktur, ancak çok büyük bir sayfa büyük ve yavaş bir yanıt oluşturur.