Fehlercodes – WhatsApp-Daten-API
Alle Fehlermeldungen folgen dem gleichen Schema: HTTP-Status + Fehlermeldung + numerischer Code + Zeitstempel.
Formen der Briefumschläge (beobachtet)
Der Proxy gibt je nach Fehlermodus eine von zwei Formen zurück:
Kurzer Fehler (Authentifizierung / Burst-Limit / Validierung):
{ "error": "Requests must be at least 0.5 seconds apart" }Ausführlicher Fehler (Lookup-Fehler bei /number/no_picture/{n}, /number-simple/{n}) — der Body wird weiterhin als WhatsAppEntry mit zusätzlichen Feldern interpretiert:
{
"number": "13105551234",
"isWAContact": true,
"error": "Whatsapp number doesn't exist",
"exists": false,
"reason": "not_found",
"status": 404,
...
}Prüfen Sie immer das Fehlerfeld, auch bei 200-Antworten (z. B. kann /number_cache den Statuscode 200 mit einer Fehlermeldung zurückgeben).
Gängige HTTP-Status
| HTTP | Bedeutung | Aktion |
|---|---|---|
| 400 | Ungültige Telefonnummer — muss dem Format ^[0-9]+$ entsprechen (nur Ziffern, kein +). | Entfernen Sie vor dem Senden alle Nicht-Ziffern. Validieren Sie die Nummer lokal mit libphonenumber. |
| 401 | Fehlender oder ungültiger x-rapidapi-key-Header. | Fügen Sie die Header x-rapidapi-key und x-rapidapi-host hinzu: wp-data.p.rapidapi.com. |
| 403 | Aktiver Tarif erforderlich, Kontingent erschöpft oder Endpunkt nicht in Ihrem Tarif enthalten. | Überprüfen Sie Ihr RapidAPI-Abonnement. Aktualisieren Sie Ihren Tarif oder laden Sie Ihr Guthaben auf. |
| 404 | Endpunkt oder Ressource nicht gefunden. | Überprüfen Sie den URL-Pfad. Bei /number/{number} wird für eine unbekannte Nummer weiterhin ein WhatsAppEntry mit isWAContact: false zurückgegeben – überprüfen Sie den Nachrichtentext, nicht den Status. |
| 429 | Burst-Limit – Anfragen zu dicht beieinander. Body: {"error":"Requests must be at least 0.5 seconds apart"}. | Zwischen den Anfragen sollten mindestens 500 ms gewartet werden (2 Anfragen/Sek.). MEGA: 250 ms (4 Anfragen/Sek.). Die Geschwindigkeit Ihres Tarifs können Sie unter /api-key-stats → roleInfo.minIntervalSeconds überprüfen. |
| 500 | Unerwarteter serverseitiger Fehler. | Wiederholen Sie den Vorgang mit exponentiellem Backoff. Melden Sie, falls das Problem weiterhin besteht. |
| 502 / 503 | Das vorgelagerte WhatsApp-Verzeichnis ist nicht verfügbar oder der Dienst ist vom vorgelagerten Dienst beschränkt. | Wiederholen Sie den Vorgang mit Backoff. Überprüfen Sie /api-status. |
| 504 | Zeitüberschreitung bei der Upstream-Suche. | Bitte versuchen Sie es erneut. Für eine schnellere Antwort versuchen Sie es mit /number/no_picture/{number}. |
Wiederholungsstrategie
- Wiederholungsversuch: 429 (mit Retry-After), 500, 502, 503, 504.
- Nicht erneut versuchen: 400, 401, 403, 404.
- Backoff: exponentiell mit Jitter. Maximal 5 Wiederholungsversuche. Retry-After-Regel immer beachten.
Beispiel 429 Körper
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }Verwandt
Was Unsere Nutzer Sagen
Echte Bewertungen von unseren zufriedenen Kunden
4.5/5 (172 Bewertungen)