· 2 min read

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

Überprüfen Sie, ob eine globale Telefonnummer bei WhatsApp registriert ist, und erhalten Sie detaillierte Profilinformationen, einschließlich Signaturen und Statusaktualisierungen.

Überprüfen Sie, ob eine globale Telefonnummer ein registriertes WhatsApp-Konto ist, und erhalten Sie detaillierte Profilinformationen.

API-URL

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

Hauptmerkmale

Die Detail-API für WhatsApp-Massen-Nummernprüfung bietet umfassende Überprüfungsmöglichkeiten:

Kontoinformationen

Detaillierte WhatsApp-Kontoinformationen einschließlich:

  • Überprüfung des Kontostatus
  • Benutzersignaturen (Statusmeldungen)
  • Zeitstempel für Statusaktualisierungen

Massenverarbeitung

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

Echtzeit-Statusaktualisierungen

Überwachen Sie den Fortschritt Ihrer Massenüberprüfungsaufgaben mit Echtzeit-Statusaktualisierungen.

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_active"'

Anfrageparameter

ParameterTypBeschreibung
filefileDatei, die Nummern enthält, eine pro Zeile
task_typestringws_active — Aktivität/Signatur

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

FeldBeschreibungBeispiel
NumberTelefonnummer im E.164-Format+491701234567
signatureSignatur des WhatsApp-Status”Hey there! I am using WhatsApp”
status_updateLetzte Aktualisierungszeit des Status2025-01-19
whatsappOb die Nummer ein aktives WhatsApp-Konto hatyes, no

API-Antwortformat

FeldBeschreibung
created_atZeitstempel, wann die Aufgabe erstellt wurde
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. Welche Informationen gibt die API zurück?

Die API gibt detaillierte Kontoinformationen zurück, einschließlich:

  • WhatsApp-Kontostatus
  • Benutzersignatur (z. B. “Hey there! I am using WhatsApp”)
  • Zeitstempel der letzten Statusaktualisierung
4. Was kostet die Detail-API?

Der Preis beträgt 2 USD pro 10.000 Nummern für detaillierte WhatsApp-Kontoinformationen, einschließlich Statusaktualisierungen und Signaturen.

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

Related Posts

View All Posts »