Wie AvatarLookup das Profilbild eines Kontos prüft

Eine Abfrage durchführen

Dieser Abschnitt behandelt die Echtzeitprodukte: Das Dashboard und die synchronen REST-Endpunkte nutzen einen gemeinsamen Abfragedienst und dieselbe Antwortbedeutung. Ganze Listen laufen über die asynchrone Massenoption, die am Ende dieser Seite beschrieben wird.

1. 1

   Quelle wählen

   service_type=ws_profile nimmt eine Nummer entgegen. service_type=email_profile nimmt eine E-Mail-Adresse entgegen und deckt Gmail, Yandex und Mail.ru in einem Produkt ab.

2. 2

   Eine Kennung senden

   Eine pro Anfrage oder bis zu 100 in einer synchronen Mehrfachanfrage. Der gesamte Stapel verwendet einen einzigen service_type.

3. 3

   Drei Felder lesen

   registered, avatar und avatar_url. Führen Sie eine neue Abfrage aus, wenn Sie einen aktuellen Status benötigen – Profilbilder ändern sich.

Welches Format der Kennung zu senden ist

Jedes Produkt akzeptiert genau eine Form der Kennung. Ein falsches Format wird vor jeder Berechnung abgelehnt.

• WhatsApp: eine Nummer im E.164-Format – ein Pluszeichen, die Ländervorwahl, dann die Teilnehmernummer ohne Leerzeichen oder Trennzeichen.
• E-Mail: eine vollständige Adresse. Nur Gmail-, Yandex- und Mail.ru-Domains werden akzeptiert; jede andere Domain wird vor der Berechnung abgelehnt, weil kein Upstream sie abdeckt.
• Nationale Nummernformate mit führenden Nullen, Leerzeichen, Bindestrichen oder Klammern werden nicht akzeptiert. Ein abgelehntes Format ist kein Ergebnis „kein Profilbild“.

Was bedeuten die drei Felder?

Sie beantworten drei verschiedene Fragen und dürfen nicht zu einer zusammengefasst werden. Ein Konto, das nicht existiert, kann kein Profilbild haben, aber ein existierendes Konto kann trotzdem keines haben – das sind unterschiedliche Ergebnisse, die gleich berechnet werden.

• registered – ob zur Kennung ein Konto auf dieser Plattform existiert.
• avatar – ob für dieses Konto ein Profilbild festgelegt ist. False ist ein Ergebnis, kein Fehler.
• avatar_url – die Bildadresse, wenn avatar true ist, andernfalls ein leerer String. Sie verweist auf das CDN der Plattform und kann nach deren Zeitplan ablaufen; behandeln Sie sie daher als Verweis, nicht als Archiv.

Das Ergebnis im vorgesehenen Rahmen nutzen

Eine Abfrage spiegelt den Status zum Anfragezeitpunkt wider. Sie ist keine Identitätsprüfung und keine Erlaubnis, jemanden zu kontaktieren.

• Ein Profilbild bestätigt nicht, wem das Konto gehört, ob es genutzt wird oder ob jemand es liest.
• Profilbilder werden jederzeit hinzugefügt, geändert und entfernt. Ein im letzten Monat gespeichertes Ergebnis dokumentiert jenen Moment, nicht den heutigen Stand.
• An das abgefragte Konto wird nichts gesendet.

Ganze Listen: die asynchrone Option

Der Echtzeit-Mehrfach-Endpunkt deckt die meisten Listen ab. Darüber hinaus senden Sie die ganze Datei als eine asynchrone Massenaufgabe – das ist auch der einzige Weg zu den Plattformen ohne Echtzeitprodukt (Telegram, Viber, LINE, MAX, Zalo).

• Laden Sie eine .txt- oder .csv-Datei mit einer Kennung pro Zeile hoch – über die Seite für Massenprüfungen oder über die API.
• Produkte für Telefonnummern erfordern beim Hochladen die Auswahl des Landes; die Produkte für Benutzernamen und E-Mail nicht.
• Beim Absenden wird Guthaben für die gültigen Zeilen reserviert, berechnet werden nur Kennungen, die ein Ergebnis liefern, und die Differenz wird erstattet.
• Die Aufgabe läuft im Hintergrund; laden Sie nach Abschluss die Ergebnis-CSV herunter. Eine fehlgeschlagene Aufgabe wird vollständig erstattet.