התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

סטטוס קונטיינר מדיה ב-Instagram: הקודים ומחזור החיים

ה-API של Instagram מפרסם דרך קונטיינרים של מדיה, ולכל אחד מהם יש 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 יוצר קונטיינר מכתובת ה-URL של תמונה או וידאו, Meta מביאה את המדיה ומכינה אותה, ואז POST /<IG_ID>/media_publish עם מזהה הקונטיינר כ-creation_id הופך אותו לפוסט. קרוסלה מוסיפה רמה: קונטיינר אחד לכל פריט, ואחריהם קונטיינר מסוג CAROUSEL שמפרט אותם כרשימת children.

מה כל קוד סטטוס אומר?

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>"
}

כל כמה זמן כדאי לבדוק את הסטטוס?

פעם בדקה, למשך לא יותר מ-5 דקות, זו ההמלצה של Meta. הבדיקה חשובה במיוחד לוידאו, כי Meta מציינת שהעלאת וידאו היא אסינכרונית: קבלת מזהה קונטיינר לא מבטיחה שההעלאה הצליחה, ורק status_code בערך FINISHED מאשר זאת.

מה קורה אם מפרסמים מוקדם מדי?

media_publish נכשל עם קוד 9007, תת-קוד 2207027: המדיה עדיין לא מוכנה לפרסום. אין צורך לתקן שום דבר בבקשה; בודקים את הסטטוס ומפרסמים כשהסטטוס מציג FINISHED. קוד 24 עם תת-קוד 2207008 שונה: קונטיינר שלא קיים או שפג תוקפו, ו-Meta ממליצה לנסות שוב פעם או פעמיים בטווח של 30 שניות עד 2 דקות, ורק אחר כך ליצור קונטיינר חדש.

כמה זמן קונטיינר תקף?

24 שעות. קונטיינר שלא פורסם בתוך הזמן הזה מקבל סטטוס EXPIRED ולא ניתן לפרסם אותו עוד. גם קוד -2 עם תת-קוד 2207020 ("the media has expired") מבקש קונטיינר חדש. חשבון יכול ליצור 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 בחלון של 24 שעות?

400 בחלון מתגלגל של 24 שעות, וזה משאיר מקום ליצור קונטיינר מחדש אחרי שגיאה.

מה משמעות config_issue אחרי פרסום?

media_publish הצליח, אבל הפוסט עלה ללא הכיתוב או ללא תיוגי המשתמשים; הסיבה היא CAPTION_NOT_ATTACHED או USER_TAGGING_FAILURE, בהתאמה.

מדוע הקונטיינר שלי נכשל עם ERROR בסוף התהליך?

הוא לא הצליח להסתיים בתהליך הפרסום. השדה status מכיל תת-קוד שגיאה עם הסיבה, ולכן מתקנים את הגורם ויוצרים קונטיינר חדש.

המשיכו לקרוא

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-