İçeriğe geç

Zalo Toplu Numara Kontrolcüsü API: Hızlı Telefon Numarası Doğrulama

Girilen küresel numaranın Zalo ayrıntılarını kontrol edin, bir Zalo hesabı mı

Algılama Dosyası Yükleme Kod örneği:

curl --location 'https://api.ekycpro.com/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./number.txt"' \
--form 'task_type="zalo"'

Görev Durumunu Kontrol Etme Kod örneği:

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

Algılama dosyası yükleme başarılı yanıtı

{
"task_id": "d4g8o46p2jvh04o9uolg",
"status": "pending",
"total": 2049,
"message": "Task created successfully",
"created_at": "2025-11-21T15:58:08.916446594Z"
}

İşleme durumu için yanıt

{
"created_at": "2025-11-21T08:27:09.933Z",
"updated_at": "2025-11-21T08:27:10.241Z",
"task_id": "d4g24nep2jvh04o9uoh0",
"user_id": "wfi7wGPS4B4PdtTMox5Y",
"status": "processing",
"total": 2049,
"success": 1024,
"failure": 0
}

Görevin tamamlandığını belirten bir yanıt sağlayın ve sonuçlar için indirme URL’sini ekleyin

{
"created_at": "2025-11-21T08:27:09.933Z",
"updated_at": "2025-11-21T08:27:10.241Z",
"task_id": "d4g24nep2jvh04o9uoh0",
"user_id": "wfi7wGPS4B4PdtTMox5Y",
"status": "exported",
"total": 2049,
"success": 2049,
"failure": 0,
"result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

Dosya yükleme istek URL’si

POST https://api.ekycpro.com/v1/tasks

Dosya yükleme istek parametreleri

ParametreAçıklama
filefile, Dosya yükle, her satır E.164 formatında bir telefon numarası içermelidir
task_typestring, Görev türü, “zalo” olarak ayarlayın

Görev durumunu kontrol etme istek URL’si

POST https://api.ekycpro.com/v1/gettasks

Görev durumunu kontrol etme istek parametreleri

ParametreAçıklama
task_idstring, Görev oluşturmadan döndürülen Görev ID’si

Sonuç Alanları

AlanAçıklamaÖrnek
NumberE.164 formatında telefon numarası+84901234567
zaloNumaranın aktif bir Zalo hesabı olup olmadığıyes, no

Yanıt Formatı

AlanAçıklama
created_atGörevin oluşturulduğu zaman damgası
updated_atSon görev durumu güncellemesinin zaman damgası
task_idBenzersiz görev tanımlayıcısı
user_idKullanıcı ID’si
statusGörev durumu:
pending: Sırada ve bekliyor
processing: Şu anda işleniyor
exported: Sonuçlar indirmeye hazır
totalİşlenen toplam telefon numarası
successBaşarıyla tanımlanan numaralar
failureİşleme başarısız olan numaralar
result_url(Opsiyonel) Durum exported olduğunda sonuçlar için indirme URL’si

Durum Kodları

DurumAçıklama
200charge, İstek başarılı, görev oluşturuldu veya durum alındı
400free, Hatalı istek, geçersiz parametreler veya dosya formatı
500free, Dahili sunucu hatası, daha sonra tekrar deneyin