Coduri de eroare — API-ul de date WhatsApp
Toate răspunsurile la eroare urmează același plic: stare HTTP + mesaj de eroare + cod numeric + marcaj temporal.
Forme de plic (observate)
Proxy-ul returnează una dintre cele două forme, în funcție de modul de eroare:
Eroare scurtă (autentificare / limită de rafală / validare):
{ "error": "Requests must be at least 0.5 seconds apart" }Eroare detaliată (căutare greșită pe /number/no_picture/{n}, /number-simple/{n}) — corpul este analizat în continuare ca o intrare WhatsAppEntry cu câmpuri suplimentare:
{
"number": "13105551234",
"isWAContact": true,
"error": "Whatsapp number doesn't exist",
"exists": false,
"reason": "not_found",
"status": 404,
...
}Verificați întotdeauna câmpul de eroare chiar și pentru 200 de răspunsuri (de exemplu, /number_cache poate returna 200 cu un mesaj de eroare în interior).
Stări HTTP comune
| HTTP | Sens | Acţiune |
|---|---|---|
| 400 | Număr de telefon nevalid — trebuie să fie format din ^[0-9]+$ (doar cifre, fără +). | Eliminați valorile non-cifre înainte de trimitere. Validați local cu libphonenumber. |
| 401 | Antetul x-rapidapi-key lipsește sau este invalid. | Adăugați anteturile x-rapidapi-key și x-rapidapi-host: wp-data.p.rapidapi.com. |
| 403 | Plan activ necesar, cota epuizată sau endpoint-ul nu se află pe nivelul dvs. | Verifică abonamentul RapidAPI. Upgradează planul sau reîncarcă-l. |
| 404 | Punct final sau resursă negăsită. | Verificați calea URL. Pentru /number/{number}, un număr necunoscut returnează în continuare o intrare WhatsAppEntry cu isWAContact: false — verificați corpul, nu starea. |
| 429 | Limită de rafale — solicitări prea apropiate. Corp: {"error":"Requests must be at least 0.5 seconds apart"}. | Mențineți un interval de repaus de cel puțin 500 ms între solicitări (2 solicitări/sec). MEGA: 250 ms (4 solicitări/sec). Citiți /api-key-stats → roleInfo.minIntervalSeconds pentru a confirma ritmul planului. |
| 500 | Eroare neașteptată la nivelul serverului. | Reîncercați cu o perioadă de așteptare exponențială. Raportați dacă persistă. |
| 502 / 503 | Directorul WhatsApp din amonte nu este disponibil sau rata serviciilor din amonte este limitată. | Reîncercați cu backoff. Verificați /api-status. |
| 504 | Căutarea în amonte a expirat. | Reîncercați o dată. Încercați /number/no_picture/{number} pentru un răspuns mai rapid. |
Strategia de reîncercare
- Reîncercare: 429 (cu Reîncercare după), 500, 502, 503, 504.
- Nu reîncercați: 400, 401, 403, 404.
- Începere: exponențială cu jitter. Limită de 5 reîncercări. Respectați întotdeauna Reîncercarea după.
Exemplul 429 corp
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }Înrudite
Ce spun utilizatorii noștri
Recenzii reale de la clienții noștri mulțumiți
Se încarcă recenziile...