خطأ Instagram API 100: معامل غير صالح ووسائط غير موجودة
يعني الخطأ 100 في واجهة برمجة التطبيقات (API) الخاصة بـ Instagram أن معاملاً في الطلب كان غير صالح، ويحدد الرمز الفرعي الحالة بالتحديد. الرمز الفرعي 33 هو حالة الوسائط غير الموجودة: معرّف الكائن غير موجود، أو لا يمكن تحميله بصلاحيات رمز الوصول (token)، أو لا يدعم الاستدعاء. تغطي الرموز الفرعية الأخرى أنواع وسائط غير معروفة، وأحجام الكاروسيل، ووسوم @، ومستلمي الرسائل المباشرة، وعمليات البحث عن الصوت.
يعيد easyCoexistence خطأ Meta إلى Claude أو ChatGPT أو كودك الخاص عندما يفشل استدعاء، مع حالة HTTP ورمز خطأ Meta ورسالته، ليتمكن الوكيل من تصحيح المعرّف أو القيمة وإعادة المحاولة.
اسم Meta لرمز الخطأ 100 في Graph API ضمن مرجع أخطاء Marketing API.
الرمز الفرعي أقل من 100: معرّف الكائن غير موجود، أو لا يمكن تحميله بسبب نقص الصلاحيات، أو لا يدعم العملية.
الرمز الفرعي أقل من 100 لنوع وسائط لا يعرفه Instagram؛ يجب أن تكون الحاوية من أحد الأنواع المتوقعة.
الرمز الفرعي أقل من 100 لأكثر من 20 وسماً من @ على وسائط واحدة.
الرمز الفرعي أقل من 100 لمستلم رسالة مباشرة لا يطابق أي مستخدم Instagram؛ تطلب Meta المعرّف المحدد لنطاق Instagram، لا معرّف المستخدم.
رمز HTTP الذي تدرجه Meta لكل صف برمز الخطأ 100 في جدول أخطاء Instagram.
ماذا يعني الخطأ 100 في Instagram؟
تعذر قبول معامل في الطلب. يسمي مرجع Marketing API من Meta الرمز 100 «معامل غير صالح»، ويسميه جدول الرسائل لديها Bad Parameter، وتقترن صفوف Instagram به error_subcode ورسالة مستخدم تضيّق المعنى، تحت حالة HTTP 400. الرمز وحده يغطي حالات مختلفة تماماً، مثل نوع وسائط خاطئ ومستلم رسالة مباشرة خاطئ، لذا اقرأ error_subcode و error_user_msg قبل تغيير أي شيء.
ماذا يعني الرمز الفرعي 33؟
أن المعرّف في الطلب لا يؤدي إلى أي مكان يستطيع هذا الرمز الوصول إليه. تقول رسالة Meta: «طلب GET غير مدعوم. الكائن ذو المعرّف غير موجود، أو لا يمكن تحميله بسبب نقص الصلاحيات، أو لا يدعم هذه العملية.» ويكون إصلاحه بالتأكد من وجود المعرّف وأن للتطبيق صلاحية الوصول إليه. في طلبات POST تسميه مراجع Meta «طلب POST غير مدعوم».
ما الذي يجعل المعرّف يفشل مع الرمز الفرعي 33؟
فحوصات تستحق التنفيذ قبل أي شيء آخر، وكل منها مرتبط بجزء من رسالة Meta:
- الكائن موجود: المنشور المحذوف أو المعرّف المكتوب بخطأ لا يترك شيئاً يمكن تحميله.
- يجب أن يكون الـ token تابعاً للحساب الذي يملكه، لأن الصلاحية لا تصل إلا إلى بيانات الحساب الذي منحها.
- نوع المعرّف صحيح: الحاوية الناتجة عن POST /<
IG_ID>/media ليست معرّف الوسائط الذي يعيدهmedia_publish. - العقدة تدعم الاستدعاء: التعليق الذي يُعثر عليه عبر الإشارات يُقرأ عبر عقدة التعليق المذكور، إلا إذا أجرى مالك التعليق الطلب.
- المعرّف جاء من تسجيل الدخول نفسه: معرّفات الرسائل من تكامل Instagram Login تختلف في الشكل عن Unified Login.
ما رموز النشر الفرعية التي تأتي مع الرمز 100؟
ستة صفوف في جدول أخطاء Instagram من Meta، كل منها يتعلق بقيمة في حاوية الوسائط. صفوف وسوم المنتجات الثلاثة تخص الإعدادات التي تستخدم وسم المنتج فقط، وهو ما تصنفه نظرة Meta العامة على أنه غير مدعوم في Instagram Login:
- 2207023: نوع الوسائط غير معروف؛ تقبل الحاويات CAROUSEL أو REELS أو STORIES كقيمة لـ
media_type. - 2207028: الكاروسيل يحتوي على عناصر أقل أو أكثر من المسموح؛ الرسالة لا تزال تقول من 2 إلى 10، بينما يسمح دليل النشر من Meta بما يصل إلى 20.
- 2207040: أكثر من 20 وسماً من @ على الوسائط؛ استخدم عدداً أقل.
- 2207035: أُرسلت مواضع وسم المنتج لفيديو، وهو لا يقبل أيّاً منها.
- 2207036: مواضع وسم المنتج مفقودة لصورة، وهي تحتاج إلى إحداثيات x و y.
- 2207037: تعذّرت إضافة وسم المنتج؛ اعرض وسم المنتجات الموجودة في القائمة المؤهلة للحساب فقط.
ما رموز الرسائل الفرعية التي تأتي مع الرمز 100؟
تسرد Meta هذه الرموز مع الرمز 100 في أخطاء الرسائل الشائعة، ولكل منها التغيير الذي يصلحه:
- 2534014: لا يوجد مستخدم Instagram مطابق؛ أرسل إلى المعرّف المحدد لنطاق Instagram القادم من webhook (خطاف الويب)، لأن معرّفات مستخدمي Instagram غير مدعومة.
- 2534015: بيانات رسالة غير صالحة؛ المحتوى غير مسموح به لنوع الرسالة هذا.
- 2534025: التعليق غير صالح للرد الخاص.
- 2534037: التطبيق ليس مالك المحادثة، لأن تطبيقاً آخر، بما فيه Meta Business AI، يحتفظ بالمحادثة.
- 2534029: النشاط التجاري محظور من إرسال الرسائل عبر API حتى تُحل انتهاكات السياسات.
ما رموز الصوت الفرعية التي تأتي مع الرمز 100؟
أحد عشر صفاً تنتمي إلى /ig_audio، وهو البحث في Audio API، ويعمل على Facebook Login وUnified Login. معظمها يتعلق بتدفق الإعلانات لاستبدال الموسيقى المحمية بحقوق النشر في Reel: user_id و ig_user_id مرسلان معاً (9050)، وpurpose مفقود أو غير صالح مع product=ADS (9052)، وaudio_replacement_mode مفقود أو غير صالح (9056، 9057)، وsearch_query مفقود أو غير مسموح (9058، 9060)، وig_media_id مفقود أو ليس Reel أو خالٍ من الموسيقى المحمية (9054، 9062، 9055)، ومشكلات partnership_ad_code (9063، 9064).
كيف يختلف عدم العثور على الوسائط عن الخطأ 100؟
يبلغ النشر عن الوسائط المفقودة برموز أخرى. يعطي جدول Meta الرمز 24 والرمز الفرعي 2207006 عندما لا يمكن العثور على الوسائط، مع احتمال نقص صلاحية أو انتهاء الـ token، ويُصلح ذلك بحاوية جديدة. والرمز 24 مع الرمز الفرعي 2207008 يعنيان أن الحاوية غير موجودة أو انتهت صلاحيتها، ويستحق الأمر إعادة المحاولة مرة أو مرتين خلال 30 ثانية إلى دقيقتين. والرمز -2 مع الرمز الفرعي 2207020 يعنيان أن الوسائط انتهت صلاحيتها. الخطأ 100 مع الرمز الفرعي 33 هو الحالة العامة، أي معرّف لا يستطيع الـ token الوصول إليه.
لماذا يعمل الاستدعاء مع تسجيل دخول ويفشل مع آخر؟
لأن الإعدادات الثلاثة تختلف في المضيف والـ token والميزات. تذهب استدعاءات Instagram Login إلى graph.instagram.com مع Instagram User access token وصلاحيات instagram_business_*، بينما يستخدم Facebook Login وUnified Login مضيف Graph وtokens الخاصة بكل منهما وصلاحيات instagram_*. تصنف نظرة Meta العامة البحث عن الهاشتاقات ووسم المنتجات وإعلانات الشراكة على أنها غير مدعومة في Instagram Login، ويعمل Audio API على الإعدادين الآخرين فقط. في Unified Login لا يعيد /me حساب Instagram، لذا تستخدم الاستدعاءات المعرّف القادم من GET /me/assigned_instagram_accounts.
كيف تُصلح الخطأ 100؟
غيّر الطلب مسترشداً بالرمز الفرعي، لأن إعادة إرساله دون تغيير تعطي الجواب نفسه. بالنسبة إلى الرمز الفرعي 33، اقرأ المعرّف مرة أخرى بطلب GET باستخدام الـ token نفسه، وتأكد أنه معرّف الوسائط المنشورة وليس معرّف حاوية. بالنسبة إلى رموز النشر، صحح القيمة التي تذكرها الرسالة. بالنسبة إلى الرسائل، أرسل إلى المعرّف المحدد لنطاق Instagram القادم من webhook. واحتفظ أيضاً بـ fbtrace_id في السجل، فهو معرّف الدعم الذي تستخدمه Meta لهذا الطلب.
الأخطاء الشائعة
- إعادة المحاولة مع الرمز الفرعي 33 دون تغيير. المعرّف أو صلاحيته خاطئة، وتجيب Meta بالطريقة نفسها حتى يتغير الطلب.
- إرسال رسالة مباشرة إلى معرّف مستخدم Instagram لشخص ما. تأخذ الرسائل المعرّف المحدد لنطاق Instagram من رسالة webhook، وترد Meta على معرّف المستخدم بالرمز الفرعي 2534014.
- استخدام معرّف الحاوية بعد النشر. التعليقات والإحصاءات والقراءات اللاحقة تتم على معرّف الوسائط الذي يعيده media_publish، لا على الحاوية.
تزوّد list_social_accounts وlist_social_posts بالحسابات ومعرّفات الوسائط التي تحتاجها هذه الاستدعاءات. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يستحق الخطأ 100 في Instagram إعادة المحاولة؟
ليس دون تغيير. يتعلق الخطأ بالطلب نفسه، بمعرّف أو قيمة أو معامل، لذا يعيد الطلب نفسه الخطأ ذاته حتى يُصحح ذلك الجزء.
لماذا يقول Instagram إن الكائن غير موجود رغم أن المنشور ظاهر؟
تحقق من المعرّف الذي أُرسل ومن الرمز الذي استُخدم معه. يشمل الرمز الفرعي 33 أيضاً كائناً لا يستطيع الـ token تحميله بسبب نقص الصلاحية، مثل وسائط تعود إلى حساب آخر.
ما المقصود بالرمز الفرعي 2207023 ضمن الخطأ 100 في النشر؟
نوع media_type المرسل غير معروف لـ Instagram. تقبل الحاويات القيم CAROUSEL أو REELS أو STORIES، أو لا تُرسل media_type لصورة واحدة؛ وقد توقفت Meta عن دعم VIDEO في 9 نوفمبر 2023.
هل يعني الخطأ 100 أن حسابي على Instagram مقيّد؟
لا. يظهر الحساب المقيّد برمز الخطأ 25 والرمز الفرعي 2207050، أما الخطأ 100 فيتعلق بقيمة في الطلب.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في