MAX Denetçi API'si: Toplu Telefon Numarası Doğrulaması

Dosyanızdaki telefon numaralarının MAX mesajlaşma uygulamasında (oneme.ru) kayıtlı olup olmadığını kontrol edin. Diğer sosyal/mesajlaşma denetçileri ile aynı toplu görev iş 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="max"'

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,
    "message": "Task created successfully",
    "created_at": "2026-05-18T11:00:00.000000000Z"
}

İşleniyor durumu yanıtı

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:01:30.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Tamamlandı yanıtı (exported)

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:03:00.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip"
}

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, örneğin `+79991234567`)
`task_type`	`string`, `max` olarak ayarla

Minimum toplu iş boyutu: görev başına 1000 numara.

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	Örnek
`Number`	E.164 formatında telefon numarası	+79991234567
`max`	Numaranın MAX mesajlaşmasında kayıtlı olup olmadığı	yes, no

Yanıt formatı

Alan	Açıklama
`created_at`	Görev oluşturulduğunda 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`
`total`	İşlenen toplam telefon numarası sayısı
`success`	Başarıyla tanımlanan numaralar
`failure`	İşlenemez numaralar
`result_url`	`status` `exported` olduğunda indirme URL’i

Durum kodları

Durum	Açıklama
`200`	`charge`, istek başarılı
`400`	`free`, hatalı istek
`500`	`free`, sunucu hatası