त्रुटि कोड — व्हाट्सएप डेटा एपीआई
सभी त्रुटि प्रतिक्रियाएँ एक ही प्रारूप का अनुसरण करती हैं: HTTP स्थिति + त्रुटि संदेश + संख्यात्मक कोड + टाइमस्टैम्प।
लिफाफे के आकार (अवलोकित)
विफलता के प्रकार के आधार पर प्रॉक्सी दो आकृतियों में से एक लौटाता है:
संक्षिप्त त्रुटि (प्रमाणीकरण / विस्फोट सीमा / सत्यापन):
{ "error": "Requests must be at least 0.5 seconds apart" }विस्तृत त्रुटि (/number/no_picture/{n}, /number-simple/{n} पर लुकअप में चूक) — बॉडी अभी भी अतिरिक्त फ़ील्ड के साथ WhatsAppEntry के रूप में पार्स होती है:
{
"number": "13105551234",
"isWAContact": true,
"error": "Whatsapp number doesn't exist",
"exists": false,
"reason": "not_found",
"status": 404,
...
}200 प्रतिक्रियाओं पर भी हमेशा त्रुटि फ़ील्ड की जाँच करें (उदाहरण के लिए, /number_cache त्रुटि संदेश के साथ 200 लौटा सकता है)।
सामान्य HTTP स्थितियाँ
| HTTP | अर्थ | कार्रवाई |
|---|---|---|
| 400 | अमान्य फ़ोन नंबर — ^[0-9]+$ से मेल खाना चाहिए (केवल अंक, + नहीं)। | भेजने से पहले गैर-अंकों को हटा दें। स्थानीय स्तर पर libphonenumber का उपयोग करके सत्यापन करें। |
| 401 | x-rapidapi-key हेडर अनुपस्थित या अमान्य है। | x-rapidapi-key और x-rapidapi-host: wp-data.p.rapidapi.com हेडर जोड़ें। |
| 403 | सक्रिय प्लान आवश्यक है, कोटा समाप्त हो गया है, या एंडपॉइंट आपके टियर में नहीं है। | RapidAPI सदस्यता की जाँच करें। प्लान अपग्रेड करें या अतिरिक्त भुगतान करें। |
| 404 | एंडपॉइंट या संसाधन नहीं मिला। | URL पथ सत्यापित करें। /number/{number} के लिए, एक अज्ञात नंबर अभी भी isWAContact: false के साथ WhatsAppEntry लौटाता है — स्थिति की नहीं, बॉडी की जाँच करें। |
| 429 | बर्स्ट लिमिट — अनुरोध बहुत पास-पास हैं। बॉडी: {"error":"Requests must be at least 0.5 seconds apart"}। | अनुरोधों के बीच कम से कम 500 मिलीसेकंड का अंतराल रखें (2 अनुरोध/सेकंड)। मेगा: 250 मिलीसेकंड (4 अनुरोध/सेकंड)। अपनी योजना की गति की पुष्टि करने के लिए /api-key-stats → roleInfo.minIntervalSeconds पढ़ें। |
| 500 | अप्रत्याशित सर्वर-पक्षीय विफलता। | एक्सपोनेंशियल बैकऑफ़ के साथ पुनः प्रयास करें। यदि समस्या बनी रहती है तो रिपोर्ट करें। |
| 502 / 503 | अपस्ट्रीम व्हाट्सएप डायरेक्टरी अनुपलब्ध है, या अपस्ट्रीम से सेवा दर सीमित है। | बैकऑफ़ के साथ पुनः प्रयास करें। /api-status की जाँच करें। |
| 504 | अपस्ट्रीम लुकअप में समय समाप्त हो गया। | एक बार पुनः प्रयास करें। तेज़ प्रतिक्रिया के लिए /number/no_picture/{number} आज़माएँ। |
पुनः प्रयास रणनीति
- पुनः प्रयास: 429 (पुनः प्रयास के बाद), 500, 502, 503, 504.
- पुनः प्रयास न करें: 400, 401, 403, 404.
- बैकऑफ़: जिटर के साथ घातीय। अधिकतम 5 बार पुनः प्रयास की सीमा। पुनः प्रयास के बाद की सुविधा का हमेशा पालन करें।
उदाहरण 429 निकाय
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }संबंधित
हमारे उपयोगकर्ता क्या कहते हैं
हमारे संतुष्ट ग्राहकों की वास्तविक समीक्षाएं
4.5/5 (172 समीक्षाएं)