cURL isteği
POST /api/v1/bulk-taskscurl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=number_validation_batch \
-F country=US \
-F [email protected]Telefon Numarası Doğrulama
Eşzamansız dosya göreviyle her numara için geçerlilik veya etkinleştirme sinyali alın. True/false sonuçları içe aktarılan listeleri inceleme, veri temizliği ve CRM bakımını destekler.
Bu ürün yalnızca eşzamansız dosya görevi olarak kullanılabilir. Gerçek zamanlı operatör sorgusu geçerlilik veya etkinlik sinyali döndürmez.
İki adım: dosyayı gönderin, ardından görevi kontrol edin
Gönderim hemen bir görev kimliği döndürür; görevi bu kimlikle kontrol edin ve başarılı olduğunda yanıt, sonuç dosyasının indirme bağlantısını içerir. Her istek kendi yanıtıyla birlikte gösterilir.
1. Dosyayı gönderin
Görev kimliği hemen döner ve dosya arka planda hazırlanırken preparing true olarak ayarlanır: geçersiz satırlar, yinelenenler ve — numara görevleri için — ülke kodu olmayan veya başka bir ülkeye ait numaralar çıkarılır ve ücretlendirilmez. Gönderilen satırlar için bakiye ayrılır ve tamamlandığında hesaplaşma yapılır; fark iade edilir.
Yanıt: görev oluşturuldu
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_validation_batch",
"status": "processing",
"country": "US",
"submitted_lines": 509,
"total": 509,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}2. Görevi kontrol edin
Görev kimliğiyle yoklama yapın. Hazırlık tamamlandığında submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt olur; burada total, kontrol edilen ve ücretlendirilen sayıdır. Başarılı bir yanıt, başarılı ve başarısız sayılarını ve sonuç dosyasının indirme bağlantısını içerir; hazırlık sırasında reddedilen bir görev reason_detail ile failed durumuna geçer ve tamamı iade edilir.
cURL isteği
GET /api/v1/bulk-tasks/{id}curl "https://api.carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Yanıt: görev tamamlandı
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_validation_batch",
"status": "success",
"country": "US",
"submitted_lines": 509,
"total": 500,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 6,
"preparing": false,
"success_cnt": 495,
"failure_cnt": 5,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}Bir toplu göreve ne olur
Toplu kontrol, gerçek zamanlı kontrolün büyütülmüş hâli değildir — bir kez gönderilir, arka planda çalışır, daha sonra alınır. Sayfayı açık tutmanız gerekmez; görev durumu ve sonuçlar panelinizde kalır.
01Dosyayı yükleyin
Her satırda bir numara bulunan bir .txt veya .csv dosyası. Doğrudan akış olarak iletilir; diske hiçbir şey yazılmaz.
02Ön kontrol ve ayırma
Belirgin sorunlar (boş dosya, yanlış biçim, çok az satır) yükleme sırasında reddedilir. Ardından bakiye ayrılır ve dosya arka planda hazırlanır: yinelenen ve geçersiz satırlar çıkarılır ve ülke kuralı kontrol edilir. Bu aşamada başarısız olan bir dosya, tamamı iade edilen başarısız bir görev olarak sonlanır; aksi takdirde yalnızca kalan satırlar kontrol edilir ve görev tamamlandığında hesaplaşma yapılır.
03Arka planda çalıştırın
Görev kendi başına çalışır — isterseniz sayfayı kapatın. Bir hata hemen bildirilir ve tamamı iade edilir.
04Sonucu indirin
Dosyayı toplu kontrol sayfasından alın. Yalnızca gerçekten sonuç döndüren numaralar için ödeme yaparsınız; fark iade edilir.
Sonuç dosyasındaki sütunlar
İndirilen dosya, sonuç tablosunun tamamını içeren tek bir CSV dosyasıdır.
Sonuç dosyası sütunları
identifier·12345678900— Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlardan oluşur (ör. 12345678900) ve sonuçları bir müşteri, potansiyel müşteri veya CRM kaydıyla eşleştirmek için sabit anahtardır. Kaynak listeyi izlemek ve sonuçları toplu olarak geri yazmak için saklayın; bu alan tek başına bir numarayla iletişim kurulabileceğini kanıtlamaz.activated·true— Geçerlilik/etkinleştirme kararı: true eşleşme, false açık olumsuz sonuçtur. Eksik veya başarısız sonuçları false ile doldurmayın. Kimliği, iletişim iznini veya arama erişilebilirliğini kanıtlamaz.
Bu ürünü ne zaman kullanmalısınız
Kayıt listesi incelemesi
Kayıt veya potansiyel müşteri listelerini içe aktardıktan sonra sonuçları form verileri, dolandırıcılık kuralları ve izinlerle inceleyin. Bu eşzamansız kontrol gerçek zamanlı kayıt kodu doğrulamasının yerini almaz.
identifier ile özgün kaydı eşleştirin ve elle inceleme için kaynağı koruyun.
Eşleştirme anahtarı: identifier
Liste temizleme
Dışa aktarımdan sonra, orijinal numarayı ve kaynak alanlarını koruyarak kayıtları aktivasyon sinyaline göre işaretleyin; iş verilerini doğrudan silmek yerine eksik veya olağan dışı sinyalleri incelemeye yönlendirin.
True, false ve eksik sonuçları ayırın; eksik kayıtları inceleme kuyruğunda tutun.
Gruplama alanı: activated
CRM veri hijyeni
Kontrol tarihini, ürünü ve sonucu özel CRM alanlarına yazın; böylece pazarlama, hizmet ve veri ekipleri sonraki iş akışlarında aynı liste durumu üzerinden çalışabilir.
Sonucu ekibinizin kaydettiği görev tarihiyle saklayın. Güncel kontrol için yeni görev gönderin.
Güncelleme alanları: identifier · activated
Toplu Numara doğrulama nedir?
Erişim kampanyasından önce E.164 numaralarını toplu olarak kontrol edin; numara ve aktivasyon sinyalleri döndürülür. Sonucu kayıtları incelemeye işaretlemek, listeleri temizlemek ve CRM veri kalitesini korumak için kullanın; dönen bir sinyal, aramanın veya mesajın ulaşacağını garanti etmez.
Bu ürünün sınırları
- activated alanını seçilen ürüne göre yorumlayın: geçerlilik/aktivasyon veya etkinlik. Etkinlik tarihi ya da sıklığı içermez.
- Sonuç kimliği veya iletişim iznini kanıtlamaz; aramanın bağlanacağını ya da mesajın ulaşacağını garanti etmez.
- Sonuçlar otomatik olarak yenilenmez. Yeniden kontrol gerektiğinde yeni bir görev gönderin.
Numara doğrulama hakkında
True, false ve eksik sonuç ne anlama gelir?
True bu kontrolde eşleşme, false açık olumsuz sonuçtur. İkisi de alınmış kararlardır; false yürütme hatası veya ücretsiz satır anlamına gelmez. Eksik, belirsiz ve başarısız sonuçları görev istatistikleri ve son hesaplaşmaya göre ayrı ele alın; false ile doldurmayın.
Son günlerdeki etkinliği gösterir veya teslimatı garanti eder mi?
Hayır. Gözlem aralığı, son etkinlik tarihi, sıklık veya etkileşim geçmişi içermez ve arama ya da mesaj teslimatını garanti etmez. Kendi iş verileriniz ve iletişim izniyle kullanın.
Bu kontrol gerçek zamanlı olarak kullanılabilir mi?
Bu ürün yalnızca eşzamansız dosya görevi olarak kullanılabilir. Gerçek zamanlı operatör sorgusu geçerlilik veya etkinlik sinyali döndürmez.
Dosyadaki geçersiz numaralara ne olur?
Ön kontrol hatalı biçimlendirilmiş satırları çıkarır, böylece bunlar asla ücretlendirilebilir sayıya girmez. Kalan numaralardan kontrol hizmetinin çözemedikleri de ücretlendirilmez. Yalnızca gerçekten sonuç döndüren numaralar için ödeme yaparsınız.
Bir görev ne kadar sürer?
Numara sayısına ve ürüne bağlıdır. Gönderdikten sonra sayfayı kapatabilirsiniz; görev arka planda çalışır ve sonuç sizi toplu kontrol sayfasında bekler.
Başarısız olursa iade alır mıyım?
Evet. Başarısız bir görevin tamamı iade edilir. Görev başarılı olur ancak bazı numaralar sonuç döndürmezse, o kısım otomatik olarak iade edilir. Ayrılan tutar ile gerçekte ücretlendirilen tutar arasındaki fark her zaman geri döner.
Diğer toplu ürünler
Küresel operatör sorgulamaNumaralardan oluşan bir dosyanın tamamını yükleyin: her biri için operatör, alt operatör, hat türü, ülke, bölge ve şehir — gerçek zamanlı operatör sorgulamasıyla aynı alanlar.Numara EtkinliğiEşzamansız dosya göreviyle her numara için etkinlik sinyali alın. Kitle gruplarını ve takip önceliklerini incelemek için true/false sonuçlarını kendi etkileşim kayıtlarınızla birleştirin.Toplu görev göndermek için hesap oluşturun
Toplu ve gerçek zamanlı kontroller aynı bakiyeden düşülür — ayrıca etkinleştirilecek bir şey yoktur. Kayıt olun ve ilk dosyanızı toplu kontrol sayfasında yükleyin.