Carrier Lookup API Entegrasyonu: Orijinal Operatör ve Hat Tipi İş Akışları

Orijinal operatör tahsisatını, hat tipini ve numaralandırma coğrafyasını gerçek zamanlı REST uç noktaları ve toplu dosya işleme yoluyla incelemek için Carrier Lookup API'yi entegre edin.

Carrier Lookup API, telekomünikasyon veri yönetimi için orijinal operatör ve numara tahsisat bağlamı sağlar. Kuruluşlar API aracılığıyla bir telefon numarasını sorguladığında, hizmet numara bloğunun başlangıçta atandığı operatörü, hat tipini ve tahsisat coğrafyasını belirten veriler döndürür. Bu bilgiler, numaralandırma planları tarafından tanımlanan idari atamayı temsil eder ve dahili yönlendirme ile risk değerlendirme iş akışları için istikrarlı bir telekomünikasyon bağlamı sağlar. Aktif abone ağı yönlendirmesinden ziyade ilk tahsisatı yansıttığı için ekipler, CarrierLookup'ı gerçek zamanlı tekil uç noktalar, çok öğeli senkron sorgular veya asenkron toplu iş dosyaları genelinde temel numara parametrelerini incelemek üzere entegre ederler.

Temel Tahsisat Verileri ve Hat Tipi Öznitelikleri

Telekomünikasyon numaralandırma düzenlemeleri, ülke kodları ve abone numaralarıyla küresel numaralandırma planlarını tanımlayan ITU-T Recommendation E.164 gibi uluslararası standartları takip eder. Bu yapılar dahilinde, düzenleyici kurumlar belirli numara bloklarını ağ operatörlerine atar. CarrierLookup, bu temel özellikleri orijinal operatör sorgulama yeteneği aracılığıyla sunar.

Yanıt şeması, telekomünikasyon bağlamını belirgin veri noktalarında düzenler:

• carrier: Numaralandırma aralığının orijinal olarak tahsis edildiği iletişim sağlayıcısı.
• underlying_carrier: Atanan aralıkla ilişkili altyapı sağlayıcısı.
• number_type: Mobil veya sabit hat ataması gibi hattın sınıflandırması.
• country_code: Tahsisat bölgesiyle eşleşen uluslararası arama ön eki.
• region ve city: Numaralandırma atama planında belirlenen idari coğrafi bölge.

Bu veri noktaları statik aralık özniteliklerini oluşturur. Numaralar, abone etkinliğinden bağımsız olarak ilk aralık tanımlarını koruduğundan, bu veriler filtreleme, telekomünikasyon analizi ve dahili kayıt düzenleme için tutarlı bir referans görevi görür.

Gerçek Zamanlı Tekil ve Çoklu Sorgu Entegrasyonu

Gerçek zamanlı sorguların entegre edilmesi, arka uç sistemlerinin uygulama girişi veya inceleme iş akışları sırasında telefon numaralarını senkronize bir şekilde değerlendirmesine olanak tanır. İstekler, güvenli bir uygulama sunucusundan gönderilen X-API-Key HTTP başlığı kullanılarak doğrulanır.

Tekil Numara Sorgulama İş Akışı

Bireysel bir tanımlayıcıyı kontrol etmek için POST /api/v1/check adresine bir istek gönderin. Yük, başında artı işareti, ülke kodu ve boşluk veya noktalama işareti içermeyen abone rakamları bulunan, uluslararası standart E.164 sözdiziminde biçimlendirilmiş bir telefon numarası gerektirir.

İşleme alındıktan sonra sunucu, code, msg ve düz bir data nesnesi içeren bir JSON yanıtı döndürür. Veri yükü service_type, identifier, carrier, underlying_carrier, number_type, country_code, region ve city bilgilerini içerir. Belirli aralıklar için ayrıntılar listelenmemişse isteğe bağlı tahsisat alanları boş dönebilir, ancak sorgu tamamlanmış olarak kaydedilir.

Senkron Çoklu Sorgu İş Akışı

Anında değerlendirme gerektiren gruplar için kuruluşlar POST /api/v1/batch-check uç noktasını çağırır. Bu uç nokta, tek bir çağrı içinde birden fazla E.164 numarasını senkronize olarak işler. Yanıt, sıralı bir diziyle birlikte üst düzey yürütme metriklerini döndürür:

• service_type: Yürütülen sorgulama hizmetini doğrular.
• total: Gönderilen tanımlayıcı sayısı.
• succeeded: Başarıyla değerlendirilen öğe sayısı.
• failed: İşleme hatalarıyla karşılaşan öğe sayısı.
• results: Her biri identifier ve exists içeren sıralı bir öğe koleksiyonu.

Bu senkron çoklu yanıtta, exists=false değeri, bağlantısı kesilmiş veya hatalı biçimlendirilmiş bir hat olduğunu iddia etmek yerine, standart bir tahsisat kaydının döndürülmediğini belirtir.

Asenkron Toplu Dosya İşleme İş Akışı

Geniş telekomünikasyon kayıt envanterleri işlenirken, ekipler asenkron carrier_batch hizmetini kullanır. Bu iş akışı, istemci bağlantılarını açık tutmadan dosya tabanlı gönderimleri yönetir.

Görev Gönderimi ve Yapısı

Toplu istekleri POST /api/v1/bulk-tasks aracılığıyla çok parçalı form verisi (multipart form data) kullanarak gönderin. Yükleme, satır başına bir tanımlayıcı içeren düz bir TXT veya CSV dosyası ile belirtilen bir ISO ülke parametresi gerektirir. Görev boyutları için ürüne özel sınırlar geçerlidir ve okuyucular güncel operasyonel parametreleri resmi API belgelerinde inceleyebilirler.

Alım sırasında, otomatik ön işleme süreci; kopyaları, hatalı girişleri ve seçilen hedefin dışındaki ülkelerle eşleşen satırları filtrelemek için liste içeriğini gözden geçirir. İşleme süreci, bu uygun olmayan girişleri sorgulama hesaplamasının dışında tutar.

Görev Yaşam Döngüsü ve Geri Alma

İstemciler, GET /api/v1/bulk-tasks/{id} sorgusu yaparak toplu işlem ilerlemesini izler. Yoklama (polling) programları, 30 saniyede birden daha sık olmayacak şekilde ölçülü bir tempoda takip edilmelidir. Görev yaşam döngüsü üç resmi durumdan geçer:

• processing: Dosya sistem değerlendirmesinden geçmektedir.
• failed: Görev bir yürütme hatasıyla karşılaştı veya alım gereksinimlerini karşılayamadı.
• success: Aralık değerlendirmesi tamamlandı ve çıktı hazır.

Bir görev success ile tamamlandığında, uç nokta tek bir CSV dosyası sağlar. Çıktı yapısı yedi standartlaştırılmış başlık içerir: identifier, carrier, underlying_carrier, number_type, country_code, region ve city. Bu dosyadaki tanımlayıcı, artı sembolleri olmadan ülke koduyla birlikte rakamlar halinde oluşturulur.

Operasyonel Sınırlar ve Kapsam Özellikleri

Bir operatör sorgulama entegrasyonu uygulamak, teknik mimarinin sistem eşzamanlılığı ve coğrafi parametrelerle uyumlu hale getirilmesini gerektirir.

Coğrafi kapsam, belirgin bölgesel kurallar içerir. Gerçek zamanlı tekil numara sorgulamaları, mütevazı operasyonel hacimler için anakara Çin (+86), Hong Kong (+852) ve Makao (+853) genelindeki sorguları karşılar. Ancak, toplu iş dosyaları bu üç bölgeden gelen numaraları kabul etmez. Tayvan (+886) için kapsam durumu henüz doğrulanmamıştır.

Sorguları çağırmadan önce hesap durumunu doğrulamak için, sorgulama tüketmeden güncel bakiyeyi almak üzere GET /api/v1/balance sorgusunu kullanın. Ayrıca, yeni kayıt olan kullanıcılar, entegrasyon iş akışlarını üretim uç noktalarına karşı doğrulamak üzere 100 ücretsiz sorgu almak için destek ekibiyle iletişime geçebilirler.

SSS

API, ağlar arasında taşınan (port edilen) numaraları nasıl işler?

CarrierLookup, numaralandırma aralığının idari otoriteler tarafından orijinal olarak atandığı operatörü bildirir. Telekomünikasyonda tüketiciler, Porting: Keeping Your Phone Number When You Change Providers belgesinde açıklandığı üzere numaralarını koruyarak sağlayıcı değiştirebilirler. Sonuç olarak, carrier alanı, numaralandırma analizi için değişmeyen bir yapısal özniteliği koruyarak, mevcut hizmet veren operatörden ziyade bu tarihsel aralık tahsisatını yansıtır.

Gerçek zamanlı çoklu sorguyu toplu iş hizmetinden ayıran nedir?

Gerçek zamanlı çoklu sorgu uç noktası POST /api/v1/batch-check, numaraları senkronize olarak değerlendirir ve service_type, total, succeeded, failed ile tanımlayıcıyı ve bir exists boolean değerini gösteren sıralı sonuçları içeren anlık bir JSON yükü döndürür. Buna karşılık, toplu iş hizmeti listeleri gönderilen CSV veya TXT dosyalarından asenkron olarak işler. Arka plan analizi bittiğinde, toplu görevler; carrier, underlying_carrier, number_type, country_code, region ve city dahil olmak üzere tam tahsisat sütunlarını içeren indirilebilir bir CSV sağlar.

Region ve city alanları cihazın fiziksel konumunu mu gösterir?

Region ve city alanları, telefon santralinin idari atamasına karşılık gelen ilk numaralandırma planı tahsisatının coğrafi sınırını belirtir. Bu değerler, abone numara bloğu için bölgesel bağlam sağlar. Bunlar, gerçek zamanlı mobil cihaz konumlandırmasını, canlı baz istasyonu bağlantılarını veya bireysel bir abonenin fiziksel nerede olduğunu değil, statik numaralandırma atamalarını temsil eder.

Daha Fazla Bilgi Edinin

İş akışınızdaki bir sonraki adıma uygun ürün bilgilerini seçin.

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