تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

أخطاء واجهة برمجة التطبيقات (API) في Instagram: معنى الرموز الشائعة

أكثر أخطاء Instagram API شيوعاً هي 190 لرمز الوصول (token) المنتهي أو غير الصالح، و4 و17 و80002 لحدود المعدل، و9004 لوسائط لا يستطيع Meta جلبها، و9007 لفيديو ما زال قيد المعالجة، و9 لحد النشر اليومي، و10 مع subcode 2534022 لرسالة خارج نافذة المراسلة. ويصل كل خطأ بصيغة JSON تتضمن الحقل code، وغالباً الحقل subcode الذي يحدد الحالة بدقة، والحقل message يصفه.

تتولى easyCoexistence الجانب المتعلق بالاتصال من هذه الأخطاء: تجدد وصول Instagram قبل انتهائه، وتفحص الحساب كل 6 ساعات، وترسل إليك بريداً إلكترونياً عندما يحتاج إلى إعادة ربط.

190

رمز خطأ Graph API يعني أن token انتهت صلاحيته أو أُلغي أو أصبح غير صالح بطريقة أخرى.

80002

رمز الخطأ لحد المعدل المعروف باسم Business Use Case الخاص بـ Instagram.

2207042

subcode ضمن الرمز 9 للحساب الذي وصل إلى حد النشر اليومي في واجهة API البرمجية.

2207052

subcode ضمن الرمز 9004 للوسائط التي تعذّر على Meta جلبها من عنوان URL المحدد.

2534041

subcode ضمن الرمز 200، عندما يوقف الحساب الوصول إلى رسائله المباشرة.

كيف تقرأ خطأ Instagram API؟

كل خطأ هو كائن JSON موجود ضمن الحقل error. يحدد الحقل code الفئة العامة، بينما يحدد error_subcode الحالة المحددة، وهو غالباً الأنفع من الاثنين، ويصف message الخطأ. وتحمل أخطاء كثيرة أيضاً error_user_title وerror_user_msg، وهما نصان موجهان إلى الشخص، وis_transient. ويُعرّف fbtrace_id الطلب لدى دعم Meta، وتنتهي صلاحيته بسرعة، لذا سجّله وقت وقوع الخطأ.

ماذا تعني أخطاء الوصول والأذونات؟

أخطاء تتعلق بمن يحق له فعل ماذا، مع الإصلاح لكل منها:

  • 190: انتهت صلاحية token أو أُلغي أو أصبح غير صالح بطريقة أخرى؛ يعني subcode 463 منتهي الصلاحية، و467 غير صالح، و460 تغيير كلمة المرور. يُصلحه token جديد، وللحساب المتصل ذلك يعني إعادة الربط.
  • 10: رفض الإذن. لم يُمنح إذن قط، أو أُزيل بعد منحه.
  • 200 إلى 299: إذن محدد مفقود، مثل الرمز 200 مع subcode 2534041 عندما يوقف الحساب الوصول إلى رسائله.
  • 25، subcode 2207050: الحساب مقيّد أو غير نشط أو خاضع لتحقق أمني؛ على المالك تسجيل الدخول إلى تطبيق Instagram وإكمال ما يطلبه.

ماذا تعني أخطاء حدود المعدل؟

تقييد للطلبات، وكلها مؤقتة:

  • 4: طلبات كثيرة جداً من التطبيق؛ انتظر ثم أعد المحاولة، أو قلّل حجم الطلبات.
  • 17: طلبات كثيرة جداً للمستخدم؛ والعلاج نفسه ينطبق.
  • 80002: حد Business Use Case في Instagram، ويُحسب لكل تطبيق وحساب استناداً إلى مرات الظهور (impressions): 4,800 طلب لكل ظهور خلال 24 ساعة.
  • 613، subcode 2534040: طلبات مراسلة كثيرة جداً؛ توقف مؤقتاً وحاول لاحقاً.

ماذا تعني أخطاء النشر المتعلقة بالوسائط؟

أخطاء تتعلق بالملف ومكان استضافته؛ لا تستحق إعادة المحاولة كما هي إلا المهلة الزمنية:

  • 9004، subcode 2207052: تعذّر على Meta جلب الوسائط من عنوان URL؛ تأكد من صلاحيته وأنه عام.
  • -2، subcode 2207003: استغرق التنزيل وقتاً طويلاً؛ هذا الخطأ يستحق إعادة المحاولة.
  • 36000، subcode 2207004: الصورة أكبر من 8 MB.
  • 36001، subcode 2207005: صيغة الصورة غير مدعومة؛ استخدم JPEG.
  • 36003، subcode 2207009: نسبة العرض إلى الارتفاع خارج النطاق من 4:5 إلى 1.91:1.
  • 352، subcode 2207026: صيغة الفيديو غير مدعومة؛ استخدم MOV أو MP4.

ماذا تعني أخطاء النشر المتعلقة بالتوقيت والحدود؟

أخطاء تتعلق بالوقت والكمية، ويُحل معظمها بالانتظار أو بالبدء من جديد:

  • 9007، subcode 2207027: الوسائط غير جاهزة؛ انتظر حتى تعرض status_code الخاصة بالحاوية (container) الحالة FINISHED.
  • 24، subcode 2207008: الحاوية غير موجودة أو انتهت صلاحيتها؛ أعد المحاولة مرة أو مرتين خلال 30 ثانية إلى دقيقتين، ثم أنشئ حاوية جديدة.
  • -2، subcode 2207020: انتهت صلاحية الوسائط؛ أنشئ حاوية جديدة.
  • 9، subcode 2207042: بلغ الحساب حد النشر اليومي؛ حاول مجدداً في اليوم التالي.
  • 100، subcode 2207028: عرض الشرائح (carousel) يحتاج من عنصرين إلى 10 عناصر.
  • 36004، subcode 2207010: التعليق الوصفي أطول من المسموح؛ حدود Meta هي 2,200 حرف و20 وسماً بعلامة @، ويذكر مرجعها 30 هاشتاغاً، مع أن Instagram يسمح بخمسة في المنشور.
  • 4، subcode 2207051: قيّد Instagram الإجراء لاشتباهه في كونه spam.

ماذا تعني أخطاء المراسلة؟

أخطاء تصدر من الرسائل المباشرة (DM) والردود الخاصة (private replies):

  • 10، subcode 2534022: أُرسلت الرسالة خارج النافذة المسموح بها؛ انتظر حتى يكتب الشخص مجدداً.
  • 100، subcode 2534014: لا يوجد مستخدم Instagram مطابق؛ استخدم المعرّف المحدد بنطاق Instagram من خطاف الويب (webhook)، لا معرّف المستخدم في Instagram.
  • 100، subcode 2534025: التعليق لا يقبل رداً خاصاً.
  • 100، subcode 2534037: تطبيق آخر، بما فيه Business AI من Meta، يتحكم في المحادثة.
  • 551، subcode 1545041: الشخص غير متاح حالياً.

ماذا تعني أخطاء الإحصاءات؟

تفشل طلبات الإحصاءات بثلاث طرق موثّقة:

  • 10، عدم وجود مشاهدين كافين لعرض إحصاءات الوسائط: مقياس للقصص أقل من 5.
  • مقياس متقاعد، مثل impressions منذ 21 أبريل 2025، يعيد خطأ؛ اطلب views بدلاً منه.
  • خطأ غير معروف عندما لا يدعم أحد عدة مقاييس مطلوبة التقسيم المطلوب.

أيّ الأخطاء تستحق إعادة المحاولة؟

الأخطاء المؤقتة فقط: الرمزان 1 و2، وأخطاء خادم Instagram 2207001 و2207032، ومهلة التنزيل 2207003، والخطأ 2207008 الذي يحدث لفترة وجيزة، وحدود المعدل بعد انتهاء فترة الانتظار. أما كل ما عداها فيعطي الجواب نفسه حتى يتغير شيء، سواء الملف أو الرابط أو الإذن أو حالة الحساب أو نافذة الشخص، وإعادة المحاولة فيها تستهلك حد المعدل دون فائدة.

الأخطاء الشائعة

  • إعادة محاولة خطأ الصيغة أو الحجم. تفشل 2207004 و2207005 و2207009 و2207026 بالطريقة نفسها حتى تتغير الوسائط.
  • اعتبار 9007 فشلاً. الفيديو ما زال قيد المعالجة؛ انشر عندما تعرض الحاوية الحالة FINISHED.
  • قراءة الرمز وحده. رموز مثل 10 و100 تغطي حالات كثيرة، والـ subcode هو ما يحدد الحالة بعينها.
  • حذف fbtrace_id من السجلات. يطلبه دعم Meta، وتنتهي صلاحيته بسرعة بعد الخطأ.
إنجاز ذلك باستخدام EasyCoexistence

ثم يستدعي Claude أو ChatGPT أو كودك الخاص واجهة Meta الرسمية برمز وصول يبقى محدّثاً. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

ماذا يعني الخطأ 190 في Instagram؟

انتهت صلاحية token أو أُلغي أو أصبح غير صالح بطريقة أخرى، مثلاً بعد تغيير كلمة المرور. يُصلحه token جديد، وللحساب المتصل ذلك يعني إعادة الربط.

لماذا يفشل النشر برمز 9004؟

تعذّر على Meta جلب الوسائط من عنوان URL المحدد، وذلك بالـ subcode 2207052. تحقق من أن الرابط صالح وعام، ومن عدم وجود تسجيل دخول أمامه، وقت نشر المنشور.

ما هو الخطأ 9007؟

الفيديو الموجود في الحاوية ما زال قيد المعالجة، وذلك بالـ subcode 2207027. تحقق من status_code للحاوية وانشر عندما تصبح قيمته FINISHED.

ما هو fbtrace_id في خطأ Instagram API؟

معرّف للطلب الذي فشل، ويطلبه دعم Meta عند الإبلاغ عن مشكلة. تنتهي صلاحيته بسرعة بعد الخطأ، لذا اكتبه في سجلاتك في وقتها.

تابع القراءة

حدود النشر في Instagram API: الصيغ والأحجام والمنشورات في اليومما يحتويه منشور Instagram API وكم منشورًا يمكن نشره يوميًا: صور JPEG حتى 8 MB وReels وStories وتسميات حتى 2,200 حرف و100 منشور كل 24 ساعة.نشر Reels على Instagram عبر واجهة برمجة التطبيقات (API)كيف ينشر API من Instagram مقاطع Reels: متطلبات Meta للفيديو، والحاويات ومدة المعالجة، والمشاركة في Feed، والأغلفة، والمقاييس.رسائل Instagram المباشرة عبر API ونافذة الـ24 ساعةطريقة عمل رسائل Instagram المباشرة عبر API: من يمكن للحساب مراسلته، ونافذة الرسائل 24 ساعة، والردود الخاصة، وإعداد السماح بالوصول.إدارة تعليقات Instagram عبر واجهة برمجة التطبيقات (API)كيف تقرأ واجهة Instagram البرمجية التعليقات وترد عليها وتخفيها وتحذفها: ردود علنية، ورد خاص واحد لكل تعليق خلال 7 أيام، والقواعد المعمول بها.أحداث Instagram عبر خطاف الويب (webhook): التعليقات والإشارات والرسائل المباشرةكيف تصل تعليقات Instagram والإشارات والرسائل المباشرة إلى نقطة النهاية (endpoint) كأحداث webhook، وما تحمله كل حمولة، وكيف يُوقَّع كل تسليم.تحليلات Instagram عبر واجهة برمجة التطبيقات (API): مقاييس الحساب والمنشوراتالمقاييس التي تعيدها واجهة Instagram للحساب ولكل منشور وReels وقصة، مع حدود Meta وفترات التأخير والمقاييس المعاد تسميتها.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في