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

يمكن أن ينتج عن الطلبات المُقدمة إلى واجهات API لدينا العديد من استجابات الأخطاء المختلفة. ويوضح المستند التالي أساليب إصلاح الأخطاء ويقدم قائمة بقيم الأخطاء مزوّدة بخريطة توضح أساليب إصلاح الأخطاء الأكثر شيوعًا لاستخدامها.

استجابات الأخطاء

يمثل ما يلي استجابة خطأ شائعة تنتج عن فشل طلب واجهة API:

{
  "error": {
    "message": "Message describing the error", 
    "type": "OAuthException", 
    "code": 190,
    "error_subcode": 460,
    "error_user_title": "A title",
    "error_user_msg": "A message",
    "fbtrace_id": "EJplcsCHuLu"
  }
}

message: وصف للخطأ يمكن للأشخاص قراءته.
code: رمز الخطأ. تُدرج القيم الشائعة أدناه مع أساليب الاسترداد الشائعة.
error_subcode: معلومات إضافية عن الخطأ. تُدرج القيم الشائعة أدناه.
error_user_msg: الرسالة المطلوب عرضها للمستخدم. تستند لغة الرسالة إلى لغة طلب واجهة API.
error_user_title: عنوان مربع الحوار، في حالة عرضه. تستند لغة الرسالة إلى اللغة المحلية لطلب API.
fbtrace_id: معرف الدعم الداخلي. عند الإبلاغ عن خطأ يتعلق باستدعاء Graph API، يجب تضمين معرف fbtrace_id لمساعدتنا في العثور على بيانات السجل لاستخدامها في تصحيح الخطأ. مع ذلك، ستنتهي صلاحية هذا المعرف قريبًا. لمساعدة فريق الدعم في إعادة النظر في المشكلة، يُرجى إرفاق جلسة مستكشف graph explorer محفوظة.

رموز الأخطاء

الرمز أو النوع	الاسم	الإجراء
OAuthException		في حالة عدم وجود رمز فرعي، يعني ذلك أن حالة تسجيل الدخول أو رمز الوصول قد انتهت صلاحيته أو تم إلغاؤه أو أصبح غير صالح. الحصول على رمز وصول جديد. في حالة وجود رمز فرعي، راجع الرمز الفرعي.
102	جلسة واجهة API	في حالة عدم وجود رمز فرعي، يعني ذلك أن حالة تسجيل الدخول أو رمز الوصول قد انتهت صلاحيته أو تم إلغاؤه أو أصبح غير صالح. الحصول على رمز وصول جديد. في حالة وجود رمز فرعي، راجع الرمز الفرعي.
1	API مجهول	ربما حدثت مشكلة مؤقتة بسبب عطل ما. لذا يرجى الانتظار وإعادة محاولة العملية. وإذا تكرر حدوث المشكلة، فتأكد من أنك تطلب واجهة API موجودة.
2	خدمة API	مشكلة مؤقتة بسبب عطل ما. يرجى الانتظار بعض الوقت وإعادة العملية.
3	أسلوب API	توجد مشكلة في الإمكانية أو الأذونات. لذا تأكد من أن تطبيقك لديه الإمكانية أو الأذونات الضرورية لإجراء هذا الاستدعاء.
4	استدعاءات كثيرة للغاية لـ API	مشكلة مؤقتة بسبب التقييد. يرجى الانتظار بعض الوقت وإعادة العملية، أو فحص حجم طلب API.
17	استدعاءات كثيرة للغاية لمستخدم واجهة API	مشكلة مؤقتة بسبب التقييد. يرجى الانتظار بعض الوقت وإعادة العملية، أو يمكنك فحص حجم طلب API.
10	تم رفض إذن واجهة API	لم يتم منح الإذن أو تمت إزالته. معالجة الأذونات غير الموجودة.
190	انتهت صلاحية رمز الوصول	الحصول على رمز وصول جديد.
200-299	إذن API (قيم متعددة تبعًا للإذن)	لم يتم منح الإذن أو تمت إزالته. معالجة الأذونات غير الموجودة.
341	تم بلوغ حد التطبيق	مشكلة مؤقتة بسبب عطل أو التقييد. يرجى الانتظار بعض الوقت وإعادة العملية، أو يمكنك فحص حجم طلب API.
368	تم الحظر مؤقتًا لانتهاك السياسات	يُرجى الانتظار وإعادة العملية.
506	منشور مكرر	لا يمكن نشر المنشورات المكرر بشكل متتالٍ. قم بتغيير محتوى المنشور وحاول مرة أخرى.
1609005	خطأ في نشر الرابط	ظهرت مشكلة أثناء استخلاص بيانات من الرابط المقدم. تحقق من عنوان URL وحاول مرة أخرى.

الرموز الفرعية لأخطاء المصادقة

الرمز	الاسم	الإجراء
458	لم يتم تثبيت التطبيق	لم يسجّل المستخدم الدخول إلى تطبيقك. لذا أعد مصادقة المستخدم.
459	تم التحقق من المستخدم	يجب أن يسجّل المستخدم الدخول من خلال https://www.facebook.com أو https://m.facebook.com لإصلاح المشكلة.
460	تم تغيير كلمة السر	في نظام iOS بالإصدار 6 والإصدارات الأحدث، إذا سجّل الشخص الدخول باستخدام دفق متكامل مع نظام التشغيل، يمكنك توجيهه إلى إعدادات نظام التشغيل في Facebook على الجهاز لتحديث كلمة السر الخاصة به. وبخلاف ذلك، سيحتاج إلى تسجيل الدخول إلى التطبيق مرة أخرى.
463	انتهت صلاحيته	حالة تسجيل الدخول أو رمز الوصول قد انتهت صلاحيته أو تم إلغاؤه أو أصبح غير صالح بخلاف ذلك. معالجة أذونات الوصول منتهية الصلاحية.
464	مستخدم لم يتم تأكيده	يجب أن يسجّل المستخدم الدخول من خلال https://www.facebook.com أو https://m.facebook.com لإصلاح المشكلة.
467	رمز وصول غير صالح	انتهت صلاحية رمز الوصول أو تم إلغاؤه أو أصبح غير صالح بخلاف ذلك. معالجة أذونات الوصول منتهية الصلاحية.
492	جلسة غير صالحة	لا يتمتع المستخدم المرتبط برمز وصول الصفحة بدور ملائم في الصفحة.

رموز أخطاء تقييد معدلات الاستدعاء

تفضل بزيارة دليل تقييدات معدلات الاستدعاء لواجهة Graph API للحصول على المزيد من المعلومات حول رموز خطأ تقييد معدلات الاستدعاء.