Hata Kodları — WhatsApp Veri API'si
Tüm hata yanıtları aynı formatı izler: HTTP durumu + hata mesajı + sayısal kod + zaman damgası.
Zarf şekilleri (gözlemlenen)
Vekil sunucu, hata moduna bağlı olarak iki şekilden birini döndürür:
Kısa hata (kimlik doğrulama / işlem limiti / doğrulama):
{ "error": "Requests must be at least 0.5 seconds apart" }Ayrıntılı hata ( /number/no_picture/{n}, /number-simple/{n} üzerinde arama hatası) — gövde hala ek alanlara sahip bir WhatsAppEntry olarak ayrıştırılıyor:
{
"number": "13105551234",
"isWAContact": true,
"error": "Whatsapp number doesn't exist",
"exists": false,
"reason": "not_found",
"status": 404,
...
}200 yanıtı durumunda bile hata alanını mutlaka kontrol edin (örneğin, /number_cache, içinde bir hata mesajı bulunan 200 yanıtı döndürebilir).
Yaygın HTTP durumları
| HTTP | Anlam | Aksiyon |
|---|---|---|
| 400 | Geçersiz telefon numarası — ^[0-9]+$ ile eşleşmelidir (yalnızca rakamlar, + işareti yok). | Göndermeden önce rakam olmayan karakterleri kaldırın. Yerel olarak libphonenumber ile doğrulayın. |
| 401 | x-rapidapi-key başlığı eksik veya geçersiz. | x-rapidapi-key ve x-rapidapi-host başlıklarını ekleyin: wp-data.p.rapidapi.com. |
| 403 | Aktif plan gerekli, kota tükendi veya uç nokta sizin kademenizde değil. | RapidAPI aboneliğinizi kontrol edin. Planınızı yükseltin veya ek ödeme yapın. |
| 404 | Uç nokta veya kaynak bulunamadı. | URL yolunu doğrulayın. /number/{number} için, bilinmeyen bir numara hala isWAContact: false değeriyle bir WhatsAppEntry döndürüyor; durumu değil, içeriği kontrol edin. |
| 429 | Patlama limiti — istekler birbirine çok yakın. Gövde: {"error":"Requests must be at least 0.5 seconds apart"}. | İstekler arasında en az 500 ms bekleyin (saniyede 2 istek). MEGA: 250 ms (saniyede 4 istek). Planınızın hızını doğrulamak için /api-key-stats → roleInfo.minIntervalSeconds bölümünü okuyun. |
| 500 | Beklenmeyen sunucu tarafı hatası. | Üstel geri çekilme yöntemiyle tekrar deneyin. Sorun devam ederse raporlayın. |
| 502 / 503 | WhatsApp rehberi kullanılamıyor veya hizmet, üst kaynak tarafından hız sınırlamasına tabi tutuluyor. | Geri çekilme ile yeniden deneyin. /api-status adresini kontrol edin. |
| 504 | Yukarı akış sorgulaması zaman aşımına uğradı. | Bir kez daha deneyin. Daha hızlı yanıt için /number/no_picture/{number} adresini deneyin. |
Yeniden deneme stratejisi
- Yeniden deneme: 429 (Sonrasında Yeniden Deneme ile), 500, 502, 503, 504.
- Tekrar denemeyin: 400, 401, 403, 404.
- Geri çekilme: titreşimli üstel. 5 yeniden deneme ile sınırlandırılmıştır. Her zaman "Sonraki Yeniden Dene" seçeneğine uyulmalıdır.
Örnek 429 gövdesi
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }İlgili
Kullanıcılarımız Ne Diyor
Memnun müşterilerimizden gerçek yorumlar
Yorumlar yükleniyor...