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

WhatsApp ist eine weltweit dominierende Messaging-Plattform, und die Überprüfung des Kontostatus in großem Maßstab kann wertvolle Erkenntnisse für Unternehmen liefern. Dieser Artikel stellt die Einfache API (Simple API) für die WhatsApp-Massen-Nummernprüfung vor, die eine effiziente Überprüfung des WhatsApp-Kontostatus für mehrere Nummern gleichzeitig ermöglicht.

Hauptmerkmale

Die Einfache API für die WhatsApp-Massen-Nummernprüfung bietet wesentliche Überprüfungsfunktionen:

Kontoüberprüfung

Schnelle und zuverlässige Überprüfung des WhatsApp-Kontostatus für jede beliebige Telefonnummer weltweit.

Massenverarbeitung (Bulk Processing)

Verarbeiten Sie mehrere Nummern gleichzeitig durch Datei-Upload, was die Überprüfung in großem Maßstab effizient macht.

Echtzeit-Statusaktualisierungen

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

Nutzungsschritte

Datei-Upload

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

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

Aufgabendetails abrufen

Zum Abfragen des Status verwenden Sie POST https://api.checknumber.ai/v1/gettasks mit dem Formularfeld task_id (siehe curl unten). Alte /wa/api/simple/...-Pfade werden nicht verwendet.

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

Anfrageparameter

• file: Die Datei, die die zu überprüfenden Nummern enthält.
• task_type: Wert ws für die WhatsApp-Registrierungsprüfung. Siehe offizielle Dokumentation.

Antwortparameter

• task_id: Die ID der Aufgabe.
• created_at: Die Zeit, zu der die Aufgabe erstellt wurde.
• updated_at: Die Zeit, zu der die Aufgabe zuletzt aktualisiert wurde.
• status: Der Status der Aufgabe.
• total: Die Gesamtzahl der Nummern in der Aufgabe.
• success: Die Anzahl der erfolgreich überprüften Nummern.
• failure: Die Anzahl der fehlgeschlagenen Nummern.
• result_url: Die URL zum Herunterladen der Ergebnisdatei.

Anfragekörper

Antwortkörper

Ergebnisfelder

Die API gibt grundlegende Überprüfungsinformationen zurück, darunter:

• Telefonnummer (E.164-Format)
• WhatsApp-Kontostatus (yes/no)

API-Antwortformat

Die API bietet detaillierte Informationen zum Aufgabenstatus:

• created_at: Zeitstempel der Aufgabenerstellung
• updated_at: Zeitstempel der letzten Statusaktualisierung
• task_id: Eindeutige Aufgabenkennung
• status: Aktueller Aufgabenstatus (pending/processing/completed/exported)
• total: Gesamtzahl der verarbeiteten Nummern
• success: Erfolgreich verarbeitete Nummern
• failure: Fehlgeschlagene Verarbeitungsversuche
• result_url: Download-URL für abgeschlossene Ergebnisse

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 grundlegende Überprüfungsinformationen zurück: ob eine Telefonnummer über ein aktives WhatsApp-Konto verfügt oder nicht.

4. Was bedeuten die API-Statuscodes?

• 200: Erfolgreiche Anfrage (wird berechnet)
• 400: Ungültige Parameter oder ungültiges Dateiformat (kostenlos)
• 500: Interner Serverfehler (kostenlos)

5. Was kostet die API?

Der Preis beträgt 1 USD pro 10.000 Nummern für die grundlegende Überprüfung des WhatsApp-Kontostatus.

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