معالجة الأخطاء

افشل بلطف: افحص مظروف الخطأ، واعرض رسالة ودّية، وأعد محاولة الإخفاقات العابرة بأمان.

قراءة الخطأ

الإخفاقات تُعيد type="error" ومصفوفة message.error بأسباب مقروءة:

{
  "message": { "code": 403, "error": ["Requested with invalid token!"] },
  "data": [],
  "type": "error"
}

المعالجة المُوصى بها

• 400 / 422 — صحّح الطلب (المفاتيح أو الوسائط). لا تُعد دون تغيير.
• 401 / 403 — الـaccess token ناقص أو منتهٍ. احصل على token جديد، ثمّ أعد المحاولة مرّة.
• 500 — خطأ خادم عابر. أعد المحاولة بتراجع قصير (مثل 1ث، 2ث، 4ث).