· 2 min read
WhatsApp Numara Tespiti — Platform veya API aracılığıyla Toplu Kontrol | CheckNumber.AI
WhatsApp kayıt kontrolü için API ile adım adım rehber; curl, Python, Node.js. Toplu görevler, ~$1 / 10.000 kontrol.
WhatsApp Numara Tespit API — Entegrasyon
Ölçekte WhatsApp kaydı doğrulamak liste temizliği, dolandırıcılık önleme, lead kalifikasyonu ve CRM için kritiktir. CheckNumber.AI toplu API’si için curl, Python ve Node.js örnekleri aşağıdadır.
Nasıl çalışır?
Üretimde toplu görevler kullanılır: dosya yükle → durumu sorgula → sonucu indir — numara başına tek senkron çağrı değil. Platform türüne göre işlem hızı değişir.
Referans: WhatsApp Checker — bulk registration.
Görev oluştur
POST https://api.checknumber.ai/v1/tasks
| Parametre | Açıklama |
|---|---|
file | .txt / .csv, satır başına bir E.164 |
task_type | ws — WhatsApp kayıt kontrolü |
curl:
curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="ws"'
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())
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));
Durum sorgula
POST https://api.checknumber.ai/v1/gettasks
Sonuç alanları
Number (E.164), whatsapp (yes/no).
Hatalar
| Kod | Çözüm |
|---|---|
400 | X-API-Key ve E.164 doğrula |
401 | Anahtarı kontrol et |
413 | Dosyayı böl (~50MB üst sınır) |
500 | Sonra yeniden dene |
SSS
Büyük dosya süresi kuyruğa bağlıdır. Dosya min 1 numara, max ~50MB. Başarılı satırlar genelde ücretlendirilir.
Sonraki adımlar
Notlar
Satır başına tek numara; exported olana kadar poll; resmi doküman; pricing.