WhatsApp Numara Tespiti — Platform veya API aracılığıyla Toplu Kontrol

WhatsApp Numara Tespit API’si — Adım Adım Entegrasyon Rehberi

WhatsApp kaydını ölçekte doğrulamak; pazarlama listesi temizliği, dolandırıcılık tespiti, müşteri adayı nitelendirmesi ve CRM veri doğrulaması için vazgeçilmezdir. Bu rehber, curl, Python ve Node.js kod örnekleriyle CheckNumber.AI’ın WhatsApp toplu doğrulama API’sini entegre etme sürecinde size yol gösterir.

Nasıl Çalışır?

Üretimdeki kontroller toplu görevler olarak çalışır: bir dosya yükler, durumu sorgular, sonuçları indirirsiniz — her telefon numarası için ayrı bir senkron HTTP çağrısı yapılmaz. Bu yaklaşım büyük ölçekli doğrulamaları verimli şekilde işler.

Resmi referans: WhatsApp Checker — bulk registration.

Görev gönderme

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

Parametre	Açıklama
`file`	`.txt` / `.csv`, satır başına bir E.164 numara
`task_type`	`ws` — WhatsApp kayıt kontrolü

Örnek — curl:

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

Örnek — Python:

import requests

url = "https://api.checknumber.ai/v1/tasks"
headers = {"X-API-Key": "YOUR_API_KEY"}

with open("numbers.txt", "rb") as f:
    files = {"file": f, "task_type": (None, "ws")}
    response = requests.post(url, headers=headers, files=files)
    
print(response.json())
# Output: {"task_id": "xyz123", "status": "pending", "total": 1000}

Örnek — Node.js:

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('numbers.txt'));
form.append('task_type', 'ws');

axios.post('https://api.checknumber.ai/v1/tasks', form, {
  headers: {
    ...form.getHeaders(),
    'X-API-Key': 'YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.message));

Durumu sorgulama

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

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

Sonuç sütunları

Alan	Açıklama
`Number`	E.164 telefon numarası
`whatsapp`	`yes` / `no` — WhatsApp’ta kayıtlı mı

Sık Karşılaşılan Hatalar ve Sorun Giderme

Hata	Neden	Çözüm
`400 Bad Request`	Eksik API anahtarı veya geçersiz dosya biçimi	`X-API-Key` başlığının bulunduğundan emin olun; E.164 biçimini kullanın (ör. `+41798284651`)
`401 Unauthorized`	Geçersiz API anahtarı	Panelden API anahtarınızı kontrol edin
`413 Payload Too Large`	Dosya boyut sınırını aşıyor	Partilere bölün; yükleme başına en fazla 50MB
`500 Server Error`	Geçici sunucu sorunu	30 saniye sonra yeniden deneyin

SSS

S: Toplu doğrulama ne kadar sürer? C: Kuyruk yüküne bağlı olarak, 100.000 numaraya kadar olan dosyalar için genellikle 5-30 saniye.

S: Minimum ve maksimum dosya boyutu nedir? C: Minimum 1 numara, en fazla 50 MB’tır (CSV biçiminde genellikle ~5M numara).

S: Krediler yalnızca başarılı kontrollerde mi düşülür? C: Evet. Yalnızca başarıyla doğrulanan sonuçlar kredi tüketir. Başarısız satırlar ücretlendirilmez.

Sonraki Adımlar

Başlamaya hazır mısınız? 1.000 ücretsiz kontrol alın →
Tüm fiyatları görün: Fiyatlandırma Sayfası →
Tam API dokümantasyonu: API Dokümantasyonu →

Entegrasyon notları

Satır başına bir numara; ülke kodunu E.164 biçiminde ekleyin.
status değeri exported olana kadar sorgulayın, ardından result_url kullanın.
Resmi dokümantasyona bakın.
Fiyatlandırma: fiyatlar.