Toplu Operatör Sorgu API'si: Hat Türü ve Operatör

Telefon numaralarının operatör ve hat türü bilgilerini toplu olarak sorgulayın. task_type değerini ülkeye özgü operatör koduna ayarlayın (örneğin usaCarrier, deCarrier, idCarrier); gelişmiş US/CA tespiti için us_carrier_premium kullanın. Diğer denetleyicilerle aynı toplu görev iş akışı.

Algılama dosyası yükleyin — örnek:

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="usaCarrier"'

Görev durumunu kontrol edin — örnek:

curl --location 'https://api.numberchecker.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Yükleme başarılı yanıtı

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2026-04-28T11:58:08.916446594Z"
}

İşleniyor durumu yanıtı

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Tamamlandı yanıtı (exported)

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

Dosya yükleme istek URL’i

POST https://api.numberchecker.ai/v1/tasks

Dosya yükleme istek parametreleri

Parametre	Açıklama
`file`	`file`, her satırda bir telefon numarası (E.164 formatında)
`task_type`	`string`, `usaCarrier` olarak ayarlayın

Görev durumunu kontrol edin istek URL’i

POST https://api.numberchecker.ai/v1/gettasks

Görev durumunu kontrol edin istek parametreleri

Parametre	Açıklama
`task_id`	`string`, Görev oluşturma sırasında dönen görev kimliği

Sonuç alanları

Alan	Açıklama
`number`	E.164 formatında telefon numarası
`number_type`	Hat türü (ör. mobil, sabit, sanal)
`country_code`	Ülke arama kodu
`carrier`	Operatör adı
`underlying_carrier`	Sanal numaralar için temel (ana) operatör
`region`	Bölge / eyalet
`city`	Şehir

Yanıt formatı

Alan	Açıklama
`created_at`	Görevin oluşturulduğu zaman damgası
`updated_at`	Son görev durumu güncellemesinin zaman damgası
`task_id`	Benzersiz görev tanımlayıcısı
`user_id`	Kullanıcı Kimliği
`status`	`pending` · `processing` · `exported` · `failed` (otomatik iade edilir)
`total`	İşlenen toplam telefon numarası
`success`	Başarıyla tanımlanan numaralar
`failure`	İşlenemeyen numaralar
`result_url`	`status` `exported` olduğunda indirme URL’i
`actual_amount`	(İsteğe bağlı) Fiilen tahsil edilen tutar; görev kapatıldıktan sonra döner
`estimated_amount`	(Oluşturma yanıtı) Görevin tahmini tutarı; nihai ücret görev tamamlanınca kesinleşir

Durum kodları

Durum	Açıklama
`200`	`free`, istek başarılı (ör. durum sorgusu)
`202`	`charge`, görev başarıyla oluşturuldu; tahmini tutar düşülür
`400`	`free`, hatalı istek: geçersiz parametreler veya dosya biçimi, desteklenmeyen görev türü ya da geçerli kayıt sayısının minimum partinin altında olması
`401`	`free`, eksik veya geçersiz API anahtarı
`402`	`free`, yetersiz bakiye
`404`	`free`, görev bulunamadı
`413`	`free`, yüklenen dosya çok büyük
`500`	`free`, sunucu iç hatası, daha sonra tekrar deneyin