MAX Tam Profil Kontrol Aracı API'si: Cinsiyet, Son Görülme Zamanı, Avatar

MAX mesajlaşma uygulamasında (oneme.ru) kayıtlı telefon numaraları için tam profil bilgilerini alın: hesap kimliği, görünen ad, cinsiyet, son görülme zamanı ve avatar bağlantısı.

Dosya yükleme örneği:

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

Görev durumunu kontrol etme örneği:

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,
    "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.numberchecker.ai/v1/tasks

Dosya yükleme istek parametreleri

Parametre	Açıklama
file	file, her satırda bir telefon numarası (E.164 formatında, örn. +79991234567)
task_type	string, “max_full” olarak ayarla

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

Görev durumunu kontrol etme istek URL’i

POST https://api.numberchecker.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
id	MAX hesabı iç kullanıcı kimliği (max=yes olduğunda)	75240310
name	Hesap görünen adı (ad/soyadı, kısmen boş olabilir)	Екатерина Сагайдак
gender	Hesap cinsiyeti (kullanıcı tarafından doldurulduğunda)	male, female
last_seen	Etkinlik durumu / son görülme açıklaması	last seen recently, last seen 2 days ago
avatar	Avatar görüntü URL’si (kullanıcının avatarı olmadığında boş)	https://i.oneme.ru/i?r=…

max=no olan satırların tüm profil sütunları boştur.

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ı