· 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
| Parameter | Typ | Beschreibung |
|---|---|---|
file | file | Datei, die Nummern enthält, eine pro Zeile |
task_type | string | ws_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
| Feld | Beschreibung | Beispiel |
|---|---|---|
Number | Telefonnummer im E.164-Format | +491701234567 |
signature | Signatur des WhatsApp-Status | ”Hey there! I am using WhatsApp” |
status_update | Letzte Aktualisierungszeit des Status | 2025-01-19 |
whatsapp | Ob die Nummer ein aktives WhatsApp-Konto hat | yes, no |
API-Antwortformat
| Feld | Beschreibung |
|---|---|
created_at | Zeitstempel, wann die Aufgabe erstellt wurde |
updated_at | Zeitstempel der letzten Statusaktualisierung der Aufgabe |
task_id | Eindeutige Aufgabenkennung |
status | Aufgabenstatus: pending/processing/completed/exported |
total | Gesamtzahl der verarbeiteten Telefonnummern |
success | Anzahl der erfolgreich identifizierten Nummern |
failure | Anzahl der fehlgeschlagenen Verarbeitungen |
result_url | (Optional) Download-URL für Ergebnisse, wenn der Status “exported” ist |
Statuscodes
| Status | Beschreibung |
|---|---|
200 | charge, Erfolgreiche Anfrage, Aufgabe erstellt oder Status abgerufen |
400 | free, Fehlerhafte Anfrage, ungültige Parameter oder Dateiformat |
500 | free, Interner Serverfehler, versuchen Sie es später erneut |
Hinweise zur Integration
- Jede Zeile in der Eingabedatei sollte eine Telefonnummer im E.164-Format enthalten.
- Überwachen Sie den Aufgabenstatus mithilfe der bereitgestellten
task_id. - Laden Sie die Ergebnisse von der
result_urlherunter, wenn der Status “exported” ist. - 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.