Cian Kontrolcüsü API: Toplu Telefon Numarası Doğrulama

Dosyadaki telefon numaralarının Cian.ru hesabı olup olmadığını kontrol edin. Diğer sosyal ağ / messenger kontrolcüleri ile aynı toplu görev akışını kullanır.

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

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

Görev durumunu kontrol edin — örnek:

curl --location 'https://api.checknumber.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.checknumber.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`, `cian` olarak ayarlayın

Görev durumunu kontrol etme istek URL’i

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

Görev durumunu kontrol etme 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ı
`cian`	Numaranın Cian.ru’da kayıtlı olup olmadığı (`yes` / `no` stilinde; ihraç başına etiketler)

Yanıt formatı

Alan	Açıklama
`created_at`	Görevin oluşturulduğu zaman damgası
`updated_at`	Görev durumunun son güncellenmesinin 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ı sayısı
`success`	Başarıyla tanımlanan numaralar
`failure`	İşlenmesi başarısız olan numaralar
`result_url`	`status` değeri `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