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

حالة حاوية وسائط Instagram: الرموز ودورة الحياة

تنشر واجهة API الخاصة بـ Instagram عبر حاويات الوسائط (media container)، وتُبلغ كل حاوية عن status_code: IN_PROGRESS أثناء وجودها في عملية النشر، و FINISHED عند جهوزيتها، و PUBLISHED بعد أن تصبح منشورة، و ERROR إذا تعذّر إكمالها، و EXPIRED إذا مرت 24 ساعة دون نشرها. توصي Meta بالتحقق مرة كل دقيقة، ولمدة لا تتجاوز 5 دقائق.

تُدير easyCoexistence دورة الحاوية داخل publish_instagram_post: تُنشئ الحاوية، وتنتظر انتهاء Instagram من المعالجة ثم تنشر، وبينما يُعالج الفيديو تُكمل النشر من تلقاء نفسها.

5

القيم التي قد يأخذها status_code: IN_PROGRESS، FINISHED، PUBLISHED، ERROR وEXPIRED.

24 hours

المدة التي يمكن أن تنتظرها الحاوية دون نشر قبل أن تتحول حالتها إلى EXPIRED.

1 min

الفاصل الزمني المقترح من Meta بين فحوص الحالة، بحد أقصى 5 دقائق.

400

عدد الحاويات التي يمكن لحساب Instagram إنشاؤها خلال 24 ساعة متحركة.

2207027

الرمز الفرعي للخطأ ضمن الرمز 9007 عند نشر حاوية غير جاهزة بعد.

ما هي حاوية الوسائط؟

الكائن الذي يُنشر منه المنشور. يُنشئ POST /<IG_ID>/media حاوية من رابط صورة أو فيديو، فتجلب Meta الوسائط وتُجهزها، ثم يحوّلها POST /<IG_ID>/media_publish، مع تمرير معرّف الحاوية في creation_id، إلى منشور. وتضيف المنشورات من نوع عرض الشرائح (carousel) مستوى إضافيًا: حاوية لكل عنصر، ثم حاوية CAROUSEL تسرد هذه العناصر بوصفها عناصر فرعية.

ماذا تعني كل قيمة من قيم الحالة؟

يُرجع GET /<IG_CONTAINER_ID>?fields=status_code واحدة من خمس قيم، ولكل منها خطوتها التالية:

  • IN_PROGRESS: ما زالت الحاوية في عملية النشر؛ انتظر ثم تحقق مرة أخرى.
  • FINISHED: الحاوية ووسائطها جاهزة؛ انشرها.
  • PUBLISHED: الوسائط منشورة بالفعل؛ لم يبقَ شيء لنشره.
  • ERROR: لم تكتمل الحاوية عملية النشر؛ يحتوي حقل status على رمز فرعي للخطأ يوضح السبب، ويلزم إنشاء حاوية جديدة.
  • EXPIRED: لم تُنشر خلال 24 ساعة؛ أنشئ حاوية جديدة.
Checking a container's status
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code

{
  "status_code": "FINISHED",
  "id": "<IG_CONTAINER_ID>"
}

كم مرة يجب التحقق من الحالة؟

توصي Meta بمرة كل دقيقة، ولمدة لا تتجاوز 5 دقائق. ويكون التحقق أهم ما يكون في الفيديو، إذ تنص Meta على أن رفع الفيديو غير متزامن: فاستلام معرّف الحاوية لا يضمن نجاح الرفع، وما يؤكد ذلك هو status_code بقيمة FINISHED.

ماذا يحدث إذا نشرت مبكرًا؟

يفشل media_publish بالرمز 9007 والرمز الفرعي 2207027: الوسائط غير جاهزة للنشر. ولا يحتاج الطلب إلى أي تعديل؛ تحقق من الحالة وانشر عندما تصبح FINISHED. أما الرمز 24 مع الرمز الفرعي 2207008 فمختلف، وهو يعني أن الحاوية غير موجودة أو انتهت صلاحيتها، وتقترح Meta إعادة المحاولة مرة أو مرتين خلال 30 ثانية إلى دقيقتين قبل إنشاء حاوية جديدة.

كم تدوم الحاوية؟

24 ساعة. الحاوية التي لا تُنشر خلال هذه المدة تصبح EXPIRED ولا يمكن نشرها بعد ذلك، ويطلب الرمز -2 مع الرمز الفرعي 2207020، أي انتهاء صلاحية الوسائط، إنشاء حاوية جديدة أيضًا. ويمكن للحساب إنشاء 400 حاوية خلال 24 ساعة متحركة، وهذا يترك مجالًا لإعادة الإنشاء بعد أي فشل.

ماذا تُبلغ الحاوية أيضًا؟

حقلان إضافيان، وملاحظة تصدر عن النشر. يحتوي status على رمز فرعي للخطأ كلما كانت قيمة status_code هي ERROR. ويوضح copyright_check_status، في حالة الفيديو، ما إذا كان فحص حقوق النشر من Meta قد أُجري وما إذا وجد تطابقات. وبعد النشر، قد يُرجع media_publish القيم config_issue أو CAPTION_NOT_ATTACHED أو USER_TAGGING_FAILURE، عندما يُنشر المنشور دون وصفه أو دون وسوم المستخدمين.

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

  • اعتبار معرّف الحاوية رفعًا مكتملًا. رفع الفيديو غير متزامن، ولا يؤكد جاهزية الوسائط إلا status_code بقيمة FINISHED.
  • النشر أثناء ظهور IN_PROGRESS. يفشل الطلب بالرمز الفرعي 2207027 حتى تصبح القيمة FINISHED.
  • الاحتفاظ بالحاوية لأكثر من يوم. بعد 24 ساعة دون نشر تصبح EXPIRED، ولا يُنشر إلا بحاوية جديدة.
  • قراءة status_code وحده عند الفشل. عندما تكون القيمة ERROR، يحمل حقل status الرمز الفرعي الذي يحدد السبب.
إنجاز ذلك باستخدام EasyCoexistence

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

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

ماذا يعني IN_PROGRESS على حاوية Instagram؟

لا تزال Meta تُجهّز الوسائط. انتظر ثم تحقق مرة أخرى، لأن النشر قبل أن تصبح الحالة FINISHED يفشل بالرمز 9007.

كم عدد حاويات الوسائط التي يمكن لحساب Instagram إنشاؤها؟

400 خلال 24 ساعة متحركة، وهذا يترك مجالًا لإعادة إنشاء حاوية بعد أي فشل.

ماذا يعني config_issue بعد النشر؟

نجح media_publish، لكن المنشور ظهر دون وصفه CAPTION_NOT_ATTACHED، أو دون وسوم المستخدمين USER_TAGGING_FAILURE.

لماذا انتهت حاويتي بالحالة ERROR؟

لم تكتمل عملية النشر. يحمل حقل status رمزًا فرعيًا للخطأ يوضح السبب؛ عالج ذلك السبب ثم أنشئ حاوية جديدة.

تابع القراءة

جدولة منشورات إنستغرام عبر واجهة برمجة التطبيقات (API)كيف تعمل المنشورات المجدولة على إنستغرام عبر API: قائمة انتظار تحفظ كل منشور وتنشره في الموعد المحدد، والوسائط على رابط عام.ضبط غلاف Reels عبر واجهة Instagram APIضبط غلاف Reel عبر API: صورة JPEG بـ cover_url أو إطار من الفيديو بـ thumb_offset، مع مواصفات Meta وطريقة قص الغلاف.نشر Reels على Instagram عبر واجهة برمجة التطبيقات (API)كيف ينشر API من Instagram مقاطع Reels: متطلبات Meta للفيديو، والحاويات ومدة المعالجة، والمشاركة في Feed، والأغلفة، والمقاييس.حدود النشر في Instagram API: الصيغ والأحجام والمنشورات في اليومما يحتويه منشور Instagram API وكم منشورًا يمكن نشره يوميًا: صور JPEG حتى 8 MB وReels وStories وتسميات حتى 2,200 حرف و100 منشور كل 24 ساعة.أخطاء واجهة برمجة التطبيقات (API) في Instagram: معنى الرموز الشائعةأخطاء Instagram API الشائعة ومعانيها: رموز الوصول المنتهية، وحدود المعدل، والوسائط التي لا يستطيع Meta جلبها، وحد النشر، ونوافذ الرسائل المغلقة.

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

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

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

تم التحقق في