API WP

Kody błędów — API danych WhatsApp

Wszystkie odpowiedzi dotyczące błędów zawierają następujący schemat: status HTTP + komunikat o błędzie + kod numeryczny + znacznik czasu.

Kształty kopert (obserwowane)

W zależności od trybu awarii serwer proxy zwraca jeden z dwóch kształtów:

Krótki błąd (autoryzacja / limit serii / walidacja):

{ "error": "Requests must be at least 0.5 seconds apart" }

Błąd opisowy (brak wyszukiwania w /number/no_picture/{n}, /number-simple/{n}) — treść nadal jest analizowana jako wpis WhatsApp z dodatkowymi polami:

{
  "number": "13105551234",
  "isWAContact": true,
  "error":  "Whatsapp number doesn't exist",
  "exists": false,
  "reason": "not_found",
  "status": 404,
  ...
}

Zawsze sprawdzaj pole błędu, nawet jeśli jest ich 200 (np. /number_cache może zwrócić 200 z komunikatem o błędzie).

Typowe statusy HTTP

HTTPOznaczającyDziałanie
400Nieprawidłowy numer telefonu — musi być zgodny ze znakami ^[0-9]+$ (tylko cyfry, bez znaku +).Usuń znaki niebędące cyframi przed wysłaniem. Sprawdź poprawność lokalnie za pomocą libphonenumber.
401Brak nagłówka x-rapidapi-key lub jest on nieprawidłowy.Dodaj nagłówki x-rapidapi-key i x-rapidapi-host: wp-data.p.rapidapi.com.
403Wymagany jest aktywny plan, wykorzystano limit lub punkt końcowy nie znajduje się na Twoim poziomie.Sprawdź subskrypcję RapidAPI. Zaktualizuj plan lub doładuj.
404Nie znaleziono punktu końcowego lub zasobu.Sprawdź ścieżkę URL. W przypadku /number/{number} nieznany numer nadal zwraca WhatsAppEntry z isWAContact: false — sprawdź treść, a nie status.
429Limit serii — żądania są wysyłane zbyt blisko siebie. Treść: {"error":"Requests must be at least 0.5 seconds apart"}.Przerwa między żądaniami powinna wynosić co najmniej 500 ms (2 żądania/sek.). MEGA: 250 ms (4 żądania/sek.). Przeczytaj /api-key-stats → roleInfo.minIntervalSeconds, aby potwierdzić tempo realizacji planu.
500Nieoczekiwana awaria po stronie serwera.Spróbuj ponownie z wycofywaniem wykładniczym. Zgłoś, jeśli problem jest trwały.
502 / 503Katalog WhatsApp upstream jest niedostępny lub przepustowość usługi jest ograniczona przez upstream.Spróbuj ponownie z backoffem. Sprawdź /api-status.
504Przekroczono limit czasu wyszukiwania.Spróbuj ponownie. Aby uzyskać szybszą odpowiedź, wpisz /number/no_picture/{number}.

Strategia ponawiania prób

  • Ponów: 429 (z opcją Ponów-Po), 500, 502, 503, 504.
  • Nie próbuj ponownie: 400, 401, 403, 404.
  • Backoff: wykładniczy z jitterem. Limit 5 prób. Zawsze respektuj opcję Retry-After.

Przykład 429 ciało

HTTP/1.1 429 Too Many Requests
content-type: application/json

{ "error": "Requests must be at least 0.5 seconds apart" }

Powiązany

Limity stawek
Przykład ponawiania próby w Pythonie
Przykład ponownych prób w Node.js
Status API na żywo
Interaktywne odniesienie do API (Skalar)

Co mówią nasi użytkownicy

Prawdziwe opinie od naszych zadowolonych klientów

Ładowanie recenzji...