Instagram media container status: de codes en de levenscyclus
Instagram's API publiceert via media containers, en elke container meldt een status_code: IN_PROGRESS zolang hij nog in het publicatieproces zit, FINISHED wanneer hij klaar is, PUBLISHED zodra hij live staat, ERROR als het voltooien mislukte en EXPIRED als er 24 uur verstreken zijn zonder publicatie. Meta raadt aan elke minuut te controleren, maar niet langer dan 5 minuten.
easyCoexistence doorloopt de containercyclus binnen publish_instagram_post: het maakt de container aan, wacht tot Instagram klaar is en publiceert; zolang een video nog verwerkt wordt, rondt het de publicatie zelf af.
Mogelijke waarden van status_code: IN_PROGRESS, FINISHED, PUBLISHED, ERROR en EXPIRED.
Hoelang een container ongepubliceerd kan blijven wachten voordat de status EXPIRED wordt.
Het door Meta voorgestelde interval tussen statuscontroles, maximaal 5 minuten.
Containers die een Instagram-account in een lopende periode van 24 uur kan aanmaken.
Foutsubcode onder code 9007, voor publicatie van een container die nog niet klaar is.
Wat is een media container?
Het object waaruit een post wordt gepubliceerd. POST /<IG_ID>/media maakt er een aan van een afbeeldings- of video-URL; Meta haalt de media op en bereidt die voor, en POST /<IG_ID>/media_publish met de ID van de container als creation_id maakt er een post van. Een carrousel voegt een niveau toe: één container per item, gevolgd door een CAROUSEL-container die ze als kinderen opsomt.
Wat betekent elke statuscode?
GET /<IG_CONTAINER_ID>?fields=status_code geeft een van vijf waarden terug, elk met een eigen volgende stap:
IN_PROGRESS: de container zit nog in het publicatieproces; wacht en controleer opnieuw.- FINISHED: de container en de media ervan zijn klaar; publiceer hem.
- PUBLISHED: de media staat al live; er is niets meer te publiceren.
- ERROR: de container kon het publicatieproces niet voltooien; het veld status bevat een foutsubcode met de reden, en er is een nieuwe container nodig.
- EXPIRED: hij is niet binnen 24 uur gepubliceerd; maak een nieuwe aan.
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code
{
"status_code": "FINISHED",
"id": "<IG_CONTAINER_ID>"
}Hoe vaak moet de status gecontroleerd worden?
Eens per minuut, maar niet langer dan 5 minuten, is de aanbeveling van Meta. Het controleren is het belangrijkst bij video, want Meta wijst erop dat videouploads asynchroon zijn: een container-ID ontvangen garandeert niet dat de upload gelukt is, en pas een status_code van FINISHED bevestigt dat.
Wat gebeurt er als je te vroeg publiceert?
media_publish mislukt met code 9007, subcode 2207027: de media is nog niet klaar om te publiceren. Er hoeft niets aan het verzoek veranderd te worden; controleer de status en publiceer zodra die FINISHED aangeeft. Code 24 met subcode 2207008 is anders: een container die niet bestaat of verlopen is. Meta adviseert dan één of twee keer opnieuw te proberen, binnen 30 seconden tot 2 minuten, voordat je een nieuwe container aanmaakt.
Hoe lang blijft een container geldig?
24 uur. Een container die binnen die tijd niet gepubliceerd is, krijgt de status EXPIRED en kan niet meer gepubliceerd worden; code -2 met subcode 2207020, de media is verlopen, vraagt eveneens om een nieuwe container. Een account kan 400 containers aanmaken binnen een lopende periode van 24 uur, wat ruimte laat om er na een fout opnieuw een aan te maken.
Wat meldt een container verder?
Twee velden extra, plus een melding van de publicatie. status bevat een foutsubcode wanneer status_code op ERROR staat. copyright_check_status geeft bij een video aan of de auteursrechtcontrole van Meta is uitgevoerd en of die overeenkomsten vond. Na de publicatie kan media_publish config_issue, CAPTION_NOT_ATTACHED of USER_TAGGING_FAILURE teruggeven, wanneer de post live ging zonder bijschrift of zonder gebruikerstags.
Veelgemaakte fouten
- Een container-ID zien als een voltooide upload. Videouploads zijn asynchroon, en alleen een status_code van FINISHED bevestigt dat de media klaar is.
- Publiceren terwijl de status op IN_PROGRESS staat. De aanroep mislukt met subcode 2207027 totdat de status FINISHED aangeeft.
- Een container langer dan een dag vasthouden. Na 24 uur zonder publicatie staat hij op EXPIRED, en alleen een nieuwe container kan gepubliceerd worden.
- Bij een mislukking alleen status_code lezen. Staat die op ERROR, dan bevat het veld status de subcode die de oorzaak aanduidt.
Claude, ChatGPT of je eigen code krijgen het gepubliceerde media-ID terug, of een verwerkingsstatus terwijl easyCoexistence het afrondt. US$ 9 tot US$ 0.75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Wat betekent IN_PROGRESS bij een Instagram-container?
Meta is de media nog aan het voorbereiden. Wacht en controleer opnieuw, want publiceren voordat de status op FINISHED staat, mislukt met code 9007.
Hoeveel media containers kan een Instagram-account aanmaken?
400 binnen een lopende periode van 24 uur, wat ruimte laat om na een mislukking opnieuw een container aan te maken.
Wat betekent config_issue na het publiceren?
media_publish is geslaagd, maar de post ging live zonder bijschrift, CAPTION_NOT_ATTACHED, of zonder gebruikerstags, USER_TAGGING_FAILURE.
Waarom eindigde mijn container op ERROR?
Hij kon het publicatieproces niet voltooien. Het veld status bevat een foutsubcode met de reden; verhelp die oorzaak en maak een nieuwe container aan.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op