CarrierLookup

Toplu ürün carrier_batch

Küresel operatör sorgulama

Numaralardan 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.

Büyük listelerin tamamı için bir ek seçenek — birkaç numara için gerçek zamanlı kontrol aynı istekte yanıt verir. Gerçek zamanlı kontrol →

API sözleşmesini görüntüleKayıt Ol

API sözleşmesi

İki adım: dosyayı gönderin, ardından görevi kontrol edin

API belgelerinin tamamını okuyun API Anahtarlarını aç

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.

cURL isteğiPOST /api/v1/bulk-tasks
curl -X POST "https://carrierlookup.online/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=carrier_batch \
  -F country=US \
  -F file=@numbers.txt
Yanıt: görev oluşturuldu200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "carrier_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "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ğiGET /api/v1/bulk-tasks/{id}
curl "https://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": "carrier_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Nasıl çalışır

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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ç alanları

Sonuç dosyasındaki sütunlar

İndirilen dosya, sonuç tablosunun tamamını içeren tek bir CSV dosyasıdır.

Sonuç dosyası sütunları

  • identifier · 17253100591 — Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
  • carrier · T-Mobile — Numaranın ilk tahsis edildiği operatör. Numara taşıma sonrasındaki güncel operatör değildir.
  • underlying_carrier — Tahsis edilenden farklı olduğunda sağlayıcının bildirdiği alt operatör; sağlayıcı sunmadığında boştur.
  • number_type · Fixed Line or Mobile — Sağlayıcının bildirdiği hat türü, örneğin Fixed Line or Mobile; mevcut olmadığında boştur.
  • country_code · US — Numaranın ait olduğu ISO ülke kodu.
  • region · CA — Tahsis bölgesi; sağlayıcı sunmadığında boştur.
  • city · LOS ANGELES — Tahsis şehri; sağlayıcı sunmadığında boştur.

En uygun kullanım

Bu ürünü ne zaman kullanmalısınız

  • Liste segmentasyonu

    Tam bir numara listesini orijinal operatöre, hat türüne ve tahsis ülkesine veya bölgesine göre indirilebilir bir sonuç dosyasında düzenleyin.

  • Yönlendirme maliyeti incelemesi

    Numaraları tek tek kontrol etmeden dahili yönlendirme, satın alma veya maliyet kayıtlarını karşılaştırmak için operatör ve bölge sütunlarını kullanın.

  • Veritabanı hijyeni

    Orijinal operatörü, bölgesi veya şehri eksik olan numara kayıtlarını bulun ve tamamlama ile insan incelemesi için bir liste oluşturun. Boş, eksik ve tutarsız kayıtları ayırın; böylece sonraki analizlere fark edilmeden girmezler.

    Önerilen iş akışı: kayıtları inceleme için işaretleyin, listeyi veri tamamlama için dışa aktarın, ardından geri yazın veya sorgulamayı yeniden çalıştırın.

Doğrudan yanıt

Toplu Küresel operatör sorgulama nedir?

Toplu operatör sorgulama, gerçek zamanlı operatör sorgulamasının dosya sürümüdür ve bin numaradan başlayan listeler için tasarlanmıştır: bir dosya yükleyin, görev arka planda çalışsın ve her numara için aynı alanları içeren tek bir sonuç CSV dosyası indirin. Her numara ülke kodunu içermeli ve bir dosyadaki tüm numaralar yükleme sırasında seçtiğiniz ülkeye ait olmalıdır; ülke kodu olmayan veya başka bir ülkeye ait numaralar çıkarılır ve ücretlendirilmez.

Net sınırlar

Bu ürünün sınırları

  • Numaranın ilk tahsis edildiği şebekeyi açıklar. Numara taşınabilirliğini takip etmez; bu nedenle numaraya bugün hizmet veren operatör olmayabilir.
  • Bir ulaşılabilirlik kontrolü veya kimlik doğrulaması değildir: numaranın hizmette olup olmadığını ya da sahibinin kim olduğunu söylemez.
  • Dosyadaki numaralara hiçbir şey gönderilmez — sorgulama tahsis verileri üzerinde çalışır.
  • Sonuçlar, görevin çalıştığı andaki tahsis verilerini yansıtır ve saklanan sonuçlar sizin için asla yenilenmez. Dosyayı yeniden çalıştırmak, numaraların taşındığı operatörleri göstermez.
  • İndirme bağlantılarının süresi dolar. Dosyayı görev tamamlandıktan kısa süre sonra alın; bir bağlantının süresi dolarsa yenisi için görevi tekrar kontrol edin.

Toplu kontrol ne zaman uygun

Toplu kontrol ne zaman değer — ve gerçek zamanlı ne zaman daha hızlı

Gerçek zamanlı kontrolToplu kontrol
Kaç numaraTekli kontrolde 1 numara; çoklu istekte birkaç numara — kesin sınırlar API belgelerinde yer alırTek görevde büyük bir listenin tamamı — güncel boyut aralığı fiyatlandırma sayfasında yer alır
Sonuçları almaHemen: tekli ve çoklu uç nokta aynı yanıtta cevap verir; panel sonuçları tek tek döndürürGörev tamamlandığında bir sonuç dosyası indirin
ÜlkeSeçim gerekmez — her numara kendi ülke kodunu taşır, tek istekte serbestçe karıştırınGörev başına bir ülke; yükleme sırasında seçilir ve dosyayla birlikte gönderilir
Sonuç biçimiJSON, numara başına alanlarSonuç dosyası (tablonun tamamını içeren tek bir CSV)
Tipik kullanımKayıt sırasında CRM zenginleştirme, temsilci sorgulamaları, yönlendirme kurallarıListe segmentasyonu, yönlendirme maliyeti incelemesi, veritabanı hijyeni

Gerçek zamanlı kontrol · Fiyatlandırmayı görüntüle

Ürün SSS

Küresel operatör sorgulama hakkında

Gerçek zamanlı kontrol yerine ne zaman toplu kontrol kullanmalıyım?

Büyük bir listenin tamamı için toplu kontrolü kullanın. Birkaç numara için gerçek zamanlı kontrol, planlanacak bir görev olmadan aynı istekte yanıt verir.

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.

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.

Kayıt Ol Fiyatlandırmayı görüntüle