CarrierLookup bir numaranın operatörünü nasıl sorgular

Bir kontrolü tamamlayın

Bu bölüm gerçek zamanlı kontrolleri ele alır: SaaS paneli ve senkron REST uç noktaları tek bir kontrol hizmetini ve tek bir yanıt anlamını paylaşır. Çok büyük listeler için asenkron bir toplu seçenek vardır; bu sayfanın sonunda ele alınmıştır.

1. 1

   Bir numara gönderin

   API belgelerinde açıklandığı şekilde eksiksiz bir numara gönderin.

2. 2

   service_type=carrier kullanın

   Operatör ürünü, numaranın ilk tahsis edildiği şebekeyi hat türü ve tahsis bölgesiyle birlikte döndürür.

3. 3

   Sonucu okuyun

   Operatör alanlarını aynı yanıtta okuyun. Bu alanlar, numaraya bugün hizmet veren operatörü değil, ilk tahsisi açıklar.

Hangi numara biçimini göndermelisiniz

CarrierLookup, sorgulama başına E.164 biçiminde yazılmış bir numara kabul eder: bir artı işareti, ülke kodu, ardından boşluk veya ayırıcı olmadan abone numarası.

• Ülke kodu dahil eksiksiz numarayı gönderin. Ülke kodu olmayan ulusal bir numara sorgulanamaz.
• Baştaki sıfırlar, boşluklar, tireler veya parantezler içeren ulusal biçimler kabul edilmez — yalnızca + işaretini ve rakamları gönderin.
• Yanlış biçimdeki numaralar herhangi bir ücret alınmadan önce reddedilir; reddedilen bir biçim “sonuç yok” yanıtı değildir.

Operatör alanları ne anlama gelir?

Operatör alanları bir operatör sorgulamasının yanıtıdır: başarılı bir yanıtın üst düzeyindeki carrier, underlying_carrier, number_type, country_code, region ve city. Bu alanlar ilk tahsis edilen operatörü ve hat türünü, ülkeyi ve sağlayıcı sunduğunda tahsis bölgesini ve şehrini taşır. registered işareti yoktur — başarılı bir yanıtın kendisi sonuçtur. Diğer her şey — zaman aşımı, belirlenemeyen sonuç, geçersiz numara — bunun yerine bir hata kodu olarak döner ve o sorgulama otomatik olarak iade edilir. Boş bir değer asla “operatör yok” anlamına gelmez; sağlayıcının o alanı sunmadığı anlamına gelir.

• carrier, numaranın verildiği sırada tahsis edildiği şebekedir.
• number_type, region ve city sağlayıcı bunları sunmadığında boş olabilir; anahtarlar her zaman bulunur.
• Diğer sonuçları API yanıt koduna göre ele alın; tahsisi kendiniz çıkarsamayın.

Sonucu kapsamı içinde kullanın

Bir operatör sonucu, numaranın ilk tahsis edildiği şebekeyi açıklar. Ulaşılabilirlik kontrolü, kimlik doğrulaması veya birisiyle iletişime geçme izni değildir.

• Numaranın sahibinin kim olduğunu doğrulamaz ve numara taşınabilirliğini takip etmez — taşınmış bir numara, aralığının ilk tahsis edildiği operatörü bildirmeye devam eder.
• Bir operatör sonucu, numarayla iletişime geçmek için onay oluşturmaz.
• Sonucu mevcut operatör olarak değerlendirmeyin: numarayı yeniden sorgulamak aynı ilk tahsisi döndürür, numaranın taşınmış olabileceği şebekeyi değil.

Çok büyük listeler: asenkron seçenek

Panel çoklu kontrolü ve API çoklu uç noktası çoğu listeyi karşılar. Yalnızca bir liste bu sınırları çok aştığında dosyanın tamamını tek bir asenkron toplu görev olarak göndermek mantıklıdır.

• Toplu kontrol sayfasından veya API üzerinden, her satırda bir numara bulunan bir .txt ya da .csv dosyası yükleyin.
• Yükleme sırasında numaraların ait olduğu ülkeyi seçin; her satır yine de E.164 biçiminde olmalıdır.
• Gönderimde geçerli satırlar için bakiye ayrılır, yalnızca sonuç döndüren numaralar için ücretlendirilirsiniz ve fark iade edilir.
• Görev arka planda çalışır; tamamlandığında sonuç dosyasını indirin. Başarısız bir görevin tamamı iade edilir.