Toplu Telefon Numarası Sorgulama: Senkron Çoklu İstekler ve Toplu Dosya Görevleri

CarrierLookup'ın iki toplu işlem rotası olan senkron çoklu istek ve asenkron toplu dosya görevinin, liste boyutu ve iş akışına göre karar verme rehberi ile karşılaştırması.

CarrierLookup ile toplu telefon numarası sorgulama, iki farklı rotadan biriyle gerçekleştirilir. Senkron çoklu istek, API üzerinden 100 numaraya kadar veya kontrol paneli üzerinden 500 numaraya kadar işlem yapar ve sonuçları aynı yanıt içerisinde sıralı olarak döndürür. Toplu dosya görevi ise seçilen bir ülke için TXT veya CSV dosyası alır, asenkron olarak çalışır ve indirilebilir bir CSV dosyası ile sonuçlanır. Küçük gruplar ve canlı iş akışları için çoklu isteği, büyük listelerin tamamı için ise dosya görevini tercih edin. Her iki yöntem de mevcut operatör bilgisini ve numara tahsis bağlamını döndürür; numara taşıma sonrası güncel operatörü veya erişilebilirlik sinyalini vermez.

İki toplu işlem rotası, iki farklı görev

Toplu telefon numarası sorgulama arayan ekipler, genellikle her toplu işlem aracının aynı şekilde çalıştığını varsayar. CarrierLookup bilinçli olarak iki farklı yapı sunar ve bunları karıştırmak en yaygın planlama hatasıdır.

Senkron çoklu istek etkileşimli bir çağrıdır. E.164 formatındaki bir grup numarayı gönderir, beklersiniz ve sıralı bir yanıt alırsınız. Gruptaki numaralar farklı ülkelerden gelebilir ve ayrı bir ülke seçimi gerekmez.

Toplu dosya görevi bir iş sürecidir. Tek sütunlu bir TXT veya CSV dosyası hazırlar, bir ülke seçer, dosyayı gönderir ve sonuç için daha sonra geri dönersiniz. İşlem arka planda gerçekleşir ve çıktı, bir yanıt gövdesi yerine bir dosyadır.

Her iki rota için de ürüne özel limitler geçerlidir, bu nedenle bir işi boyutlandırmadan önce güncel API dokümantasyonunu kontrol edin.

Senkron çoklu istek nasıl çalışır?

Güvenilir bir sunucudan, X-API-Key başlığında API anahtarı ile POST /api/v1/batch-check kullanın. Kontrol paneli, tarayıcı üzerinden 500 numaraya kadar olan daha büyük gruplar için aynı imkanı sunar.

Her numara E.164 formatında yazılmalıdır: başında artı işareti, ülke kodu ve abone numarası; boşluk veya ayırıcı karakter içermemelidir. Hatalı formatlanmış bir numara, formatı nedeniyle reddedilir. Bu, düzeltilmesi gereken bir biçimlendirme sorunudur; numaranın operatörü olmadığı anlamına gelmez.

Yanıt, kaç numaranın gönderildiğini, kaçının başarılı olduğunu ve kaçının başarısız olduğunu, ardından numaraları gönderdiğiniz sırayla sonuçları raporlar. Sıralama önemlidir çünkü her cevabı, bir birleştirme anahtarı olmadan kendi tablonuzdaki bir satırla eşleştirmenize olanak tanır.

İki davranışa dikkat edilmelidir:

• Mevcut değil olarak işaretlenen bir sonuç, o numara için normal bir sonuç dönmediği anlamına gelir. Bu, numaranın geçersiz veya bağlantısının kesik olduğu anlamına gelmez.
• İstek bütünüyle zaman aşımına uğrarsa, bir birim olarak başarısız olur. Kısmi sonuç dönmez ve tutarın tamamı bakiyenize iade edilir.

Çağrı senkron olduğu için, zaman aşımını yönetmediğiniz sürece kullanıcının sayfa yüklenmesini beklediği hiçbir yolda bu çağrıyı kullanmayın.

Toplu dosya görevi nasıl çalışır?

Multipart gövde ile POST /api/v1/bulk-tasks kullanın. Multipart gönderiminde sıra önemli olduğundan, ülke alanını dosya alanından önce yerleştirin. Ardından GET /api/v1/bulk-tasks/{id} ile ilerleme durumunu okuyun.

Bir görev üç durumdan birindedir: processing, success veya failed. Durumu 30 saniyede birden daha sık sorgulamayın. Daha sık sorgulama yapmak, görevin daha erken bitmesini sağlamaz ve herhangi bir tamamlanma süresi tanımlı değildir, bu nedenle zamanlamayı bir saate göre değil, durum bilgisine göre planlayın.

Ana işlemden önce dosya ön işleme tabi tutulur. Geçersiz satırlar, kopyalar, ülke kodu olmayan numaralar ve seçilen ülke dışındaki numaralar hariç tutulur; hariç tutulan satırlar için ücret alınmaz. Dosya kabul koşullarını karşılamıyorsa görev hazırlık aşamasında başarısız olabilir; bu durumda rezerve edilen tutar cüzdanınıza tamamen iade edilir.

Başarı durumunda ZIP değil, tek bir CSV dosyası indirirsiniz. Sütunları; tanımlayıcı, operatör, temel operatör, numara türü, ülke kodu, bölge ve şehirdir. CSV içindeki tanımlayıcı, artı işareti olmayan ülke kodu ve rakamlardan oluşur, bu nedenle dosyayı veritabanınızla birleştirmeden önce kendi anahtarlarınızı normalleştirin. Boş hücreler, değerin mevcut olmadığı anlamına gelir.

Liste boyutu, ülke karışımı ve iş akışına göre seçim

Verinizin ham sayısından ziyade yapısından yola çıkın.

1. Hemen cevap gerektiren karışık ülkeli bir grup. Senkron çoklu istek kullanın. Tek dosyalık bir görev, listeyi önce ülkeye göre bölmenizi gerektirir.
2. Esasen tek bir ülkeden oluşan büyük bir liste. Dosya görevi kullanın. Ülkeyi seçin, dosyayı gönderin ve ön işlemenin kopyaları ve alakasız numaraları temizlemesine izin verin.
3. Büyük ve karışık ülkeli bir liste. Listeyi ülke koduna göre bölün ve her ülke için bir dosya görevi gönderin. Bir ülke dosyasına sığmayan her şey, 100 numaralık parçalar halinde çoklu istekler üzerinden gönderilebilir.
4. Kayıt veya CRM girişi sırasında kayıt bazlı kontrol. Tekil numara kontrolü olan POST /api/v1/check kullanın. Çin ana karası, Hong Kong ve Makao'dan gelen numaralar yalnızca küçük hacimlerde gerçek zamanlı tekil numara kontrolleri ile desteklenir, bu nedenle bunları çoklu istek veya dosya görevine değil, bu kanala yönlendirin.

Toplu işler, gece çalışan veya kampanyalar arasında yürütülen toplu görevler için de uygundur; gönderir, sorgular ve toplarsınız. Çoklu istekler ise veriyi zaten küçük parçalar halinde işleyen ve sonuçları doğrudan bir veritabanına veya CRM'e yazabilen döngüler için uygundur.

Her iki rota için faturalandırma ve bakiye kontrolleri

Her iki rota da ortak bir bakiyeden düşer ve başarıyla tamamlanan her numara, yayınlanan aynı tarife üzerinden ücretlendirilir. Başarısız veya belirlenemeyen sorgulamalar ücretlendirilmez. Operatör alanlarının tamamı boş olan tamamlanmış bir sorgulama yine de tamamlanmış bir sorgulamadır ve ücretlendirilebilir; bu nedenle boş bir satırı ücretsiz veya operatörün olmadığına dair bir kanıt olarak okumayın.

Bir dosya görevi, gönderim sırasında tahmini bir tutarı rezerve eder ve yalnızca sonuç dönen numaralar için ücret alır. Rezervin kullanılmayan kısmı veya başarısız bir görevin tüm rezervi aynı cüzdana iade edilir. Bu, bir satın alma iadesi değil, bakiyeniz içindeki bir mutabakattır.

Büyük bir gönderimden önce GET /api/v1/balance ile bakiyeyi okuyun. Bu çağrı herhangi bir ücret almaz ve rezervin bakiyenize uygun olup olmadığını size bildirir. Aynı kontrolü zamanlanmış bir işe de ekleyin; böylece düşük bakiye, işlem hattının ortasında başarısız olmak yerine çalışmayı daha başlamadan durdurur.

Sonuçları doğru okumak

Hangi rotayı seçerseniz seçin, veriler aynı anlama gelir. Operatör, numara aralığının orijinal olarak tahsis edildiği operatördür. Bu, numaraya bugün hizmet veren ağ değildir, çünkü numara taşıma işlemi orijinal tahsisi değiştirmeden numarayı taşıyabilir. Temel operatör ve numara türü bağlam ekler; bölge ve şehir ise cihazın veya kişinin nerede olduğundan ziyade tahsis coğrafyasını tanımlar.

Bu, çıktıyı gruplandırma, yönlendirme testleri ve inceleme kuyrukları için kullanışlı kılar. Bu veriler, bir numaranın arama veya mesaj alabileceğine, aktif olduğuna veya kime ait olduğuna dair bir kanıt değildir.

Her alanı orijinal tahsis özniteliği olarak saklayın, boş değerleri mevcut değil olarak etiketleyin ve kendi sistemlerinizin başka yollarla doğruladığı hiçbir alanın üzerine yazmaktan kaçının. Bu alanları tahsis bağlamı olarak değerlendiren ekipler, verilerin neyi vaat ettiği konusunda daha sonra yaşanabilecek anlaşmazlıkların çoğunu önlemiş olur.

SSS

Ekipler çoklu istek ile dosya görevi arasında nasıl karar verebilir?

Önce liste yapısına bakın. Hemen sıralı bir cevap gerektiren karışık ülkeli numaralar grubu, çoklu istek için uygundur. Esasen tek bir ülkeden oluşan büyük bir liste, arka planda çalışan ve tek bir CSV ile sonuçlanan dosya görevi için uygundur. Ürüne özel limitler geçerlidir, bu nedenle her iki rotayı boyutlandırmadan önce güncel API dokümantasyonunu doğrulayın.

Ekipler çoklu istekteki sonuçların sırasını nasıl yönetebilir?

Sonuçlar, numaraların gönderildiği sırayla geri döner, bu nedenle kendi listenizi sabit bir sırada tutun ve konum bazlı eşleştirme yapın. Mevcut değil sonucunu normal bir sonuç yok olarak değerlendirin, geçersiz numara olarak değil; format sorunlarını düzelttikten sonra yalnızca ihtiyacınız olan satırları tekrar deneyin.

Ekipler toplu görevde boşa yapılan sorgulamalardan nasıl kaçınabilir?

Görev durumunu 30 saniyede birden daha sık sorgulamayın ve durum success veya failed olduğunda durun. Tamamlanma süresi tanımlı değildir, bu nedenle işi durum bilgisi üzerine kurun. Başarı durumunda tek CSV dosyasını indirin ve mevcut kayıtlarla birleştirmeden önce tanımlayıcıyı normalleştirin.

Daha Fazla Bilgi

İş akışınızdaki bir sonraki adım için uygun olan ürün bilgisini seçin.

• Ürün dokümantasyonunu görüntüleyin →
• Ekiple görüşün →