קודי שגיאה — ממשק API של נתוני WhatsApp
כל תגובות השגיאה עוקבות אחר אותה מעטפת: סטטוס 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}, מספר לא ידוע עדיין מחזיר WhatsAppEntry עם isWAContact: false — בדוק את הגוף, לא את הסטטוס. |
| 429 | מגבלת פרץ - בקשות קרובות מדי זו לזו. גוף: {"error":"Requests must be at least 0.5 seconds apart"}. | שינה של לפחות 500 אלפיות שנייה בין בקשות (2 בקשות לשנייה). מגה: 250 אלפיות שנייה (4 בקשות לשנייה). קרא /api-key-stats → roleInfo.minIntervalSeconds כדי לאשר את קצב התוכנית שלך. |
| 500 | כשל בלתי צפוי בצד השרת. | נסה שוב עם נסיגה אקספוננציאלית. דווח אם זה נמשך. |
| 502 / 503 | ספריית WhatsApp במעלה הזרם אינה זמינה, או שתעריף השירות מוגבל מהמעלה הזרם. | נסה שוב עם גיבוי. בדוק את /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 ביקורות)