ایرر کوڈز - واٹس ایپ ڈیٹا API
تمام خرابی کے جوابات ایک ہی لفافے کی پیروی کرتے ہیں: HTTP حیثیت + غلطی کا پیغام + عددی کوڈ + ٹائم اسٹیمپ۔
لفافے کی شکلیں (مشاہدہ)
پراکسی ناکامی موڈ کے لحاظ سے دو شکلوں میں سے ایک کو لوٹاتا ہے:
مختصر غلطی (تصویر / پھٹنے کی حد / توثیق):
{ "error": "Requests must be at least 0.5 seconds apart" }لفظی خرابی (/number/no_picture/{n}، /number-simple/{n} پر تلاش کی کمی) — باڈی اب بھی اضافی فیلڈز کے ساتھ WhatsApp انٹری کے طور پر تجزیہ کرتی ہے:
{
"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]+$ سے مماثل ہونا چاہیے (صرف ہندسے، نہیں +)۔ | بھیجنے سے پہلے غیر ہندسوں کو پٹی کریں۔ مقامی طور پر لب فون نمبر کے ساتھ تصدیق کریں۔ |
| 401 | غائب یا غلط x-rapidapi-key ہیڈر۔ | ہیڈر x-rapidapi-key اور x-rapidapi-host: wp-data.p.rapidapi.com شامل کریں۔ |
| 403 | فعال منصوبہ درکار ہے، کوٹہ ختم ہو گیا ہے، یا آپ کے درجے پر اختتامی نقطہ نہیں ہے۔ | RapidAPI سبسکرپشن چیک کریں۔ اپ گریڈ پلان یا ٹاپ اپ۔ |
| 404 | اختتامی نقطہ یا وسیلہ نہیں ملا۔ | URL کے راستے کی تصدیق کریں۔ /number/{number} کے لیے، ایک نامعلوم نمبر اب بھی isWAContact کے ساتھ WhatsApp Entry واپس کرتا ہے: false — باڈی چیک کریں، اسٹیٹس نہیں۔ |
| 429 | برسٹ حد — درخواستیں ایک ساتھ بہت قریب ہیں۔ باڈی: {"error":"Requests must be at least 0.5 seconds apart"}۔ | درخواستوں کے درمیان کم از کم 500 ms کی نیند (2 req/sec)۔ MEGA: 250 ms (4 req/sec)۔ اپنے پلان کی رفتار کی تصدیق کرنے کے لیے /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 دوبارہ کوششوں پر کیپ۔ ہمیشہ Retry-After کا احترام کریں۔
مثال 429 باڈی
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }متعلقہ
ہمارے صارفین کیا کہتے ہیں
ہمارے مطمئن گاہکوں کی حقیقی جائزے
جائزے لوڈ ہو رہے ہیں...