Foutcodes — WhatsApp-gegevens-API
Alle foutmeldingen volgen dezelfde structuur: HTTP-status + foutmelding + numerieke code + tijdstempel.
Vormen van enveloppen (waargenomen)
De proxy retourneert een van twee vormen, afhankelijk van de aard van de fout:
Korte foutmelding (authenticatie / burstlimiet / validatie):
{ "error": "Requests must be at least 0.5 seconds apart" }Uitgebreide foutmelding (lookup miss op /number/no_picture/{n}, /number-simple/{n}) — de body wordt nog steeds geparseerd als een WhatsAppEntry met extra velden:
{
"number": "13105551234",
"isWAContact": true,
"error": "Whatsapp number doesn't exist",
"exists": false,
"reason": "not_found",
"status": 404,
...
}Controleer altijd het foutveld, zelfs bij 200-reacties (bijvoorbeeld /number_cache kan 200 retourneren met een foutmelding erin).
Veelvoorkomende HTTP-statussen
| HTTP | Betekenis | Actie |
|---|---|---|
| 400 | Ongeldig telefoonnummer — moet overeenkomen met ^[0-9]+$ (alleen cijfers, geen +). | Verwijder niet-cijfers voordat je het verzendt. Valideer lokaal met libphonenumber. |
| 401 | Ontbrekende of ongeldige x-rapidapi-key-header. | Voeg de headers x-rapidapi-key en x-rapidapi-host toe: wp-data.p.rapidapi.com. |
| 403 | Actief abonnement vereist, quotum overschreden of eindpunt valt niet binnen uw abonnementscategorie. | Controleer je RapidAPI-abonnement. Upgrade je abonnement of vul je tegoed aan. |
| 404 | Eindpunt of bron niet gevonden. | Controleer het URL-pad. Voor /nummer/__PLAATSHOUDER_0__ geeft een onbekend nummer nog steeds een WhatsAppEntry met isWAContact: false terug — controleer de inhoud, niet de status. |
| 429 | Burstlimiet — verzoeken te dicht op elkaar. Body: {"error":"Requests must be at least 0.5 seconds apart"}. | Houd minimaal 500 ms aan tussen verzoeken (2 verzoeken/sec). MEGA: 250 ms (4 verzoeken/sec). Lees /api-key-stats → roleInfo.minIntervalSeconds om de timing van uw plan te controleren. |
| 500 | Onverwachte serverfout. | Probeer het opnieuw met exponentiële backoff. Rapporteer als het probleem aanhoudt. |
| 502 / 503 | De WhatsApp-directory van de upstream-provider is niet beschikbaar of de service is door de upstream-provider beperkt. | Probeer het opnieuw met een wachttijd. Controleer /api-status. |
| 504 | Upstream-zoekopdracht is mislukt door een time-out. | Probeer het nog een keer. Probeer /nummer/geen_afbeelding/__PLAATSHOUDER_0__ voor een snellere reactie. |
Opnieuw proberen strategie
- Opnieuw proberen: 429 (met opnieuw proberen na), 500, 502, 503, 504.
- Niet opnieuw proberen: 400, 401, 403, 404.
- Terugval: exponentieel met jitter. Maximaal 5 herhaalpogingen. Altijd de herhaalpogingsafspraak respecteren.
Voorbeeld 429 body
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }Verwant
Wat Onze Gebruikers Zeggen
Echte reviews van onze tevreden klanten
4.5/5 (173 reviews)