Codici di errore — API dati di WhatsApp
Tutte le risposte di errore seguono lo stesso schema: stato HTTP + messaggio di errore + codice numerico + timestamp.
Forme degli inviluppi (osservate)
Il proxy restituisce una delle due forme a seconda della modalità di errore:
Errore breve (autenticazione / limite di burst / convalida):
{ "error": "Requests must be at least 0.5 seconds apart" }Errore dettagliato (ricerca non riuscita su /number/no_picture/{n}, /number-simple/{n}) — il corpo viene comunque analizzato come un WhatsAppEntry con campi aggiuntivi:
{
"number": "13105551234",
"isWAContact": true,
"error": "Whatsapp number doesn't exist",
"exists": false,
"reason": "not_found",
"status": 404,
...
}Controlla sempre il campo degli errori anche in caso di risposte con codice 200 (ad esempio, /number_cache può restituire 200 con un messaggio di errore al suo interno).
Stati HTTP comuni
| AMD | Senso | Azione |
|---|---|---|
| 400 | Numero di telefono non valido: deve corrispondere a ^[0-9]+$ (solo cifre, senza +). | Rimuovere i caratteri non numerici prima dell'invio. Convalidare localmente con libphonenumber. |
| 401 | Intestazione x-rapidapi-key mancante o non valida. | Aggiungi le intestazioni x-rapidapi-key e x-rapidapi-host: wp-data.p.rapidapi.com. |
| 403 | Piano attivo richiesto, quota esaurita o endpoint non incluso nel tuo piano tariffario. | Verifica l'abbonamento a RapidAPI. Aggiorna il piano o effettua una ricarica. |
| 404 | Endpoint o risorsa non trovati. | Verifica il percorso URL. Per /number/{number}, un numero sconosciuto restituisce comunque un WhatsAppEntry con isWAContact: false — controlla il corpo, non lo stato. |
| 429 | Limite di burst: richieste troppo ravvicinate. Corpo: {"error":"Requests must be at least 0.5 seconds apart"}. | Attendi almeno 500 ms tra le richieste (2 richieste/sec). MEGA: 250 ms (4 richieste/sec). Leggi /api-key-stats → roleInfo.minIntervalSeconds per confermare la frequenza del tuo piano. |
| 500 | Errore imprevisto lato server. | Riprova con un intervallo di tempo esponenziale. Segnala se il problema persiste. |
| 502 / 503 | Elenco dei servizi WhatsApp non disponibile oppure servizio limitato dalla fonte originale. | Riprova con un intervallo di tempo maggiore. Controlla /api-status. |
| 504 | Ricerca a monte scaduta. | Riprova. Prova /number/no_picture/{number} per una risposta più rapida. |
Strategia di riprova
- Riprova: 429 (con Riprova in seguito), 500, 502, 503, 504.
- Non riprovare: 400, 401, 403, 404.
- Backoff: esponenziale con jitter. Limite massimo a 5 tentativi. Rispettare sempre Retry-After.
Esempio 429 corpo
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }Imparentato
Cosa Dicono i Nostri Utenti
Recensioni reali dai nostri clienti soddisfatti
4.5/5 (176 recensioni)