MAX-Vollprofil-Prüfer-API: Geschlecht, letzte Aktivität, Avatar

Rufen Sie für beim MAX Messenger (oneme.ru) registrierte Telefonnummern vollständige Profilinformationen ab: Konto-ID, Anzeigename, Geschlecht, letzte Aktivität und Avatar-Link.

Beispiel zum Hochladen der Prüfdatei:

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

Beispiel zum Prüfen des Aufgabenstatus:

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

Antwort nach erfolgreichem Hochladen

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2026-05-18T11:00:00.000000000Z"
}

Antwort während der Verarbeitung

{
    "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
}

Antwort nach Abschluss (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"
}

Anfrage-URL zum Hochladen der Datei

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

Anfrageparameter zum Hochladen der Datei

Parameter	Beschreibung
file	file, eine Telefonnummer pro Zeile (E.164-Format, z. B. +79991234567)
task_type	string, auf max_full setzen

Mindestgröße eines Stapels: 1000 Nummern pro Aufgabe.

Anfrage-URL zum Prüfen des Aufgabenstatus

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

Anfrageparameter zum Prüfen des Aufgabenstatus

Parameter	Beschreibung
task_id	string, Aufgaben-ID aus der Aufgabenerstellung

Ergebnisfelder

Feld	Beschreibung	Beispiel
Number	Telefonnummer im E.164-Format	+79991234567
max	Ob die Nummer beim MAX Messenger registriert ist	yes, no
id	Interne Benutzer-ID des MAX-Kontos (nur bei max=yes)	75240310
name	Anzeigename des Kontos (Vor-/Nachname kann teilweise leer sein)	Екатерина Сагайдак
gender	Geschlecht des Kontos (wenn vom Benutzer angegeben)	male, female
last_seen	Aktivitätsstatus / Beschreibung der letzten Aktivität	last seen recently, last seen 2 days ago
avatar	URL des Avatarbilds (leer, wenn der Benutzer keinen Avatar hat)	https://i.oneme.ru/i?r=…

Bei Zeilen mit max=no sind alle Profilspalten leer.

Antwortformat

Feld	Beschreibung
created_at	Zeitstempel der Aufgabenerstellung
updated_at	Zeitstempel der letzten Statusaktualisierung
task_id	Eindeutige Aufgabenkennung
user_id	Benutzer-ID
status	pending · processing · exported
total	Insgesamt verarbeitete Telefonnummern
success	Erfolgreich identifizierte Nummern
failure	Nummern mit fehlgeschlagener Verarbeitung
result_url	Download-URL bei Status exported

Statuscodes

Status	Beschreibung
200	charge, Anfrage erfolgreich
400	free, Ungültige Anfrage
500	free, Serverfehler