Codes d'erreur — API de données WhatsApp
Toutes les réponses d'erreur suivent la même structure : statut HTTP + message d'erreur + code numérique + horodatage.
Formes d'enveloppes (observées)
Le proxy renvoie l'une des deux formes suivantes en fonction du mode de défaillance :
Erreur de courte durée (autorisation / limite de rafale / validation) :
{ "error": "Requests must be at least 0.5 seconds apart" }Erreur détaillée (recherche infructueuse sur /number/no_picture/{n}, /number-simple/{n}) — le corps est toujours analysé comme un WhatsAppEntry avec des champs supplémentaires :
{
"number": "13105551234",
"isWAContact": true,
"error": "Whatsapp number doesn't exist",
"exists": false,
"reason": "not_found",
"status": 404,
...
}Vérifiez toujours le champ d'erreur même pour les réponses 200 (par exemple, /number_cache peut renvoyer 200 avec un message d'erreur à l'intérieur).
Statuts HTTP courants
| HTTP | Signification | Action |
|---|---|---|
| 400 | Numéro de téléphone invalide — doit correspondre à ^[0-9]+$ (chiffres uniquement, sans +). | Supprimez les caractères non numériques avant l'envoi. Validez localement avec libphonenumber. |
| 401 | En-tête x-rapidapi-key manquant ou invalide. | Ajoutez les en-têtes x-rapidapi-key et x-rapidapi-host : wp-data.p.rapidapi.com. |
| 403 | Abonnement actif requis, quota épuisé ou point de terminaison non inclus dans votre niveau. | Vérifiez votre abonnement RapidAPI. Passez à un forfait supérieur ou rechargez votre compte. |
| 404 | Point de terminaison ou ressource introuvable. | Vérifiez le chemin de l'URL. Pour /number/{number}, un numéro inconnu renvoie toujours une entrée WhatsApp avec isWAContact : false ; vérifiez le corps du message, pas le statut. |
| 429 | Limite de rafale — requêtes trop rapprochées. Corps : {"error":"Requests must be at least 0.5 seconds apart"}. | Attendez au moins 500 ms entre chaque requête (2 requêtes/s). MEGA : 250 ms (4 requêtes/s). Consultez /api-key-stats → roleInfo.minIntervalSeconds pour connaître le rythme de votre forfait. |
| 500 | Défaillance inattendue côté serveur. | Réessayer avec un délai exponentiel. Signaler en cas de problème persistant. |
| 502 / 503 | Répertoire WhatsApp en amont indisponible ou service limité par le serveur en amont. | Réessayez avec un délai d'attente. Consultez /api-status. |
| 504 | Délai d'attente dépassé pour la requête en amont. | Réessayez une fois. Pour une réponse plus rapide, essayez /number/no_picture/{number}. |
Stratégie de nouvelle tentative
- Réessayer : 429 (avec Réessayer après), 500, 502, 503, 504.
- Ne pas réessayer : 400, 401, 403, 404.
- Délai d'attente : exponentiel avec gigue. Limite de 5 tentatives. Respectez toujours l'option « Réessayer après ».
Exemple 429 corps
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }En rapport
Ce que disent nos utilisateurs
Vrais avis de nos clients satisfaits
Chargement des avis...