· 3 min read

Tiefen-API für WhatsApp-Massen-Nummernprüfung

Überprüfen Sie globale Telefonnummern auf WhatsApp-Konten und rufen Sie detaillierte demografische Informationen ab, einschließlich Geschlecht, Alter, Haarfarbe und Profilbildanalyse.

Überprüfen Sie die Demografie und Profilattribute globaler Telefonnummern auf WhatsApp, einschließlich Geschlecht, Alter und Profilbildanalyse.

API-URL

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

Hauptmerkmale

Die Tiefen-API (Deep API) für die WhatsApp-Massen-Nummernprüfung bietet leistungsstarke Analysefunktionen:

Demografische Analyse

Die API liefert detaillierte demografische Informationen aus Profilbildern, einschließlich:

  • Geschlechtserkennung
  • Altersschätzung
  • Haarfarbenanalyse
  • Erkennung der Hautfarbe / ethnischen Zugehörigkeit

Profilattribute

Umfassende Profilinformationen, einschließlich:

  • Überprüfung des WhatsApp-Kontostatus
  • Abrufen der Profilbild-URL
  • Klassifizierung des Profilbildtyps
  • Kontoverifizierungsstatus

Massenverarbeitung

Verarbeiten Sie mehrere Nummern gleichzeitig durch Datei-Upload, was eine effiziente Analyse in großem Maßstab ermöglicht.

Nutzungsschritte

Datei-Upload

Laden Sie eine Textdatei hoch, die Telefonnummern im E.164-Format enthält:

Beispielanfrage

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

Anfrageparameter

ParameterTypBeschreibung
filefileDatei mit zu überprüfenden Nummern, eine Nummer pro Zeile
task_typestringws_avatar — Attribute aus dem Profilbild

Statusprüfung

Überwachen Sie den Verarbeitungsstatus Ihrer Aufgabe:

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

Antwortbeispiele

Antwort zur Aufgabenerstellung

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Antwort zum Verarbeitungsstatus

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Antwort zur abgeschlossenen Aufgabe

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

Ergebnisfelder der WhatsApp-Nummernprüfung

FeldBeschreibungBeispiel
NumberTelefonnummer im E.164-Format+491701234567
ageGeschätzter Altersbereich basierend auf dem Profilbild25
avatarURL des WhatsApp-Profilbildshttps://checknumber.ai/avatar.jpg
categoryTypklassifizierung des ProfilbildsEinzelporträt, Haustier-Avatar, Objekt usw.
genderAnhand des Profilbilds erkanntes Geschlechtmale, female
hair_colorAnhand des Profilbilds erkannte Haarfarbeblack, brown, blonde usw.
whatsappOb die Nummer ein aktives WhatsApp-Konto hatyes, no

API-Antwortformat

FeldBeschreibung
created_atZeitstempel der Aufgabenerstellung
updated_atZeitstempel der letzten Statusaktualisierung der Aufgabe
task_idEindeutige Aufgabenkennung
statusAufgabenstatus: pending/processing/completed/exported
totalGesamtzahl der verarbeiteten Telefonnummern
successAnzahl der erfolgreich identifizierten Nummern
failureAnzahl der fehlgeschlagenen Verarbeitungen
result_url(Optional) Download-URL für Ergebnisse, wenn der Status “exported” ist

Statuscodes

StatusBeschreibung
200charge, Erfolgreiche Anfrage, Aufgabe erstellt oder Status abgerufen
400free, Fehlerhafte Anfrage, ungültige Parameter oder Dateiformat
500free, Interner Serverfehler, versuchen Sie es später erneut

Hinweise zur Integration

  1. Jede Zeile in der Eingabedatei sollte eine Telefonnummer im E.164-Format enthalten.
  2. Überwachen Sie den Aufgabenstatus mithilfe der bereitgestellten task_id.
  3. Laden Sie die Ergebnisse von der result_url herunter, wenn der Status “exported” ist.
  4. Behandeln Sie verschiedene Statuscodes in Ihrer Anwendung entsprechend.

Häufig gestellte Fragen (FAQ)

1. Wie hoch ist die Verarbeitungskapazität der API?

Die API kann große Mengen von Nummern effizient verarbeiten und bietet Echtzeit-Statusaktualisierungen zum Verarbeitungsfortschritt.

2. In welchem Format sollte die Eingabedatei vorliegen?

Die Eingabedatei sollte eine Textdatei sein, die eine Telefonnummer pro Zeile im E.164-Format (z. B. +491701234567) enthält.

3. Wie genau ist die demografische Analyse?

Die demografische Analyse basiert auf einer fortschrittlichen KI-Verarbeitung von Profilbildern und liefert Schätzungen für Alter, Geschlecht und andere Attribute, sofern diese verfügbar sind.

4. Was bedeuten die API-Statuscodes?

Die API verwendet standardmäßige HTTP-Statuscodes, um Erfolg oder Misserfolg anzuzeigen:

  • 200: Erfolgreiche Anfrage (wird berechnet)
  • 400: Ungültige Parameter oder ungültiges Dateiformat (kostenlos)
  • 500: Interner Serverfehler (kostenlos)
5. Was kostet die Tiefen-API (Deep API)?

Der Preis beträgt 6 USD pro 10.000 Nummern. Diese API-Antwortinformationen umfassen:

  • Überprüfung des WhatsApp-Kontostatus
  • Geschlechtserkennung
  • Altersschätzung
  • Profilbild-Typanalyse
  • Ethnien-Erkennung
  • Haarfarbenanalyse

Für weitere Informationen zu Preisen und zur Verarbeitung größerer Volumen kontaktieren Sie uns bitte.

Related Posts

View All Posts »