Status von Instagram-Media-Containern: Codes und Lebenszyklus
Die API von Instagram veröffentlicht über Media-Container, und jeder meldet einen status_code: IN_PROGRESS, solange er sich noch im Veröffentlichungsprozess befindet, FINISHED, wenn er bereit ist, PUBLISHED, sobald er live ist, ERROR, wenn die Fertigstellung fehlschlug, und EXPIRED, wenn 24 Stunden ohne Veröffentlichung vergangen sind. Meta empfiehlt, einmal pro Minute zu prüfen, höchstens 5 Minuten lang.
easyCoexistence führt den Container-Zyklus innerhalb von publish_instagram_post aus: Es erstellt den Container, wartet, bis Instagram fertig ist, und veröffentlicht.
Mögliche Werte von status_code: IN_PROGRESS, FINISHED, PUBLISHED, ERROR und EXPIRED.
Wie lange ein Container unveröffentlicht warten kann, bevor sein Status auf EXPIRED wechselt.
Metas empfohlenes Intervall zwischen Statusprüfungen, höchstens 5 Minuten lang.
Container, die ein Instagram-Konto in einem gleitenden Zeitraum von 24 Stunden erstellen kann.
Fehler-Subcode unter Code 9007 für die Veröffentlichung eines Containers, der noch nicht bereit ist.
Was ist ein Media-Container?
Das Objekt, aus dem ein Beitrag veröffentlicht wird. POST /<IG_ID>/media erstellt einen aus einer Bild- oder Video-URL, Meta ruft die Medien ab und bereitet sie vor, und POST /<IG_ID>/media_publish mit der ID des Containers als creation_id macht daraus einen Beitrag. Ein Karussell fügt eine Ebene hinzu: ein Container pro Element, dann ein CAROUSEL-Container, der sie als untergeordnete Container auflistet.
Was bedeutet jeder Statuscode?
GET /<IG_CONTAINER_ID>?fields=status_code liefert einen von fünf Werten, jeder mit einem eigenen nächsten Schritt:
IN_PROGRESS: Der Container befindet sich noch im Veröffentlichungsprozess; warten und erneut prüfen.- FINISHED: Der Container und seine Medien sind bereit; jetzt veröffentlichen.
- PUBLISHED: Die Medien sind bereits live; es bleibt nichts zu veröffentlichen.
- ERROR: Der Container konnte den Veröffentlichungsprozess nicht abschließen; das Feld status enthält einen Fehler-Subcode mit dem Grund, und ein neuer Container ist nötig.
- EXPIRED: Er wurde nicht innerhalb von 24 Stunden veröffentlicht; einen neuen erstellen.
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code
{
"status_code": "FINISHED",
"id": "<IG_CONTAINER_ID>"
}Wie oft sollte der Status geprüft werden?
Einmal pro Minute, höchstens 5 Minuten lang, empfiehlt Meta. Am wichtigsten ist das Prüfen bei Videos, denn Meta weist darauf hin, dass Video-Uploads asynchron sind: Eine Container-ID zu erhalten garantiert nicht, dass der Upload funktioniert hat, und erst ein status_code von FINISHED bestätigt das.
Was passiert, wenn man zu früh veröffentlicht?
media_publish schlägt mit Code 9007, Subcode 2207027 fehl: Die Medien sind noch nicht zur Veröffentlichung bereit. An der Anfrage muss nichts korrigiert werden; den Status prüfen und veröffentlichen, sobald FINISHED angezeigt wird. Code 24 mit Subcode 2207008 ist etwas anderes, nämlich ein Container, der nicht existiert oder abgelaufen ist. Meta empfiehlt, ein- oder zweimal im Abstand von 30 Sekunden bis 2 Minuten erneut zu versuchen, bevor ein neuer Container erstellt wird.
Wie lange ist ein Container gültig?
24 Stunden. Ein Container, der innerhalb dieser Zeit nicht veröffentlicht wird, zeigt EXPIRED und kann nicht mehr veröffentlicht werden. Auch Code -2 mit Subcode 2207020, die Medien sind abgelaufen, verlangt einen neuen Container. Ein Konto kann 400 Container in einem gleitenden Zeitraum von 24 Stunden erstellen, was nach einem Fehler Raum lässt, einen erneut zu erstellen.
Was meldet ein Container sonst noch?
Zwei weitere Felder und ein Hinweis aus der Veröffentlichung. status enthält einen Fehler-Subcode, sobald status_code ERROR anzeigt. copyright_check_status gibt bei einem Video an, ob Metas Urheberrechtsprüfung gelaufen ist und ob sie Übereinstimmungen gefunden hat. Nach der Veröffentlichung kann media_publish config_issue, CAPTION_NOT_ATTACHED oder USER_TAGGING_FAILURE zurückgeben, wenn der Beitrag ohne seine Bildunterschrift oder seine Nutzermarkierungen live ging.
Häufige Fehler
- Eine Container-ID als abgeschlossenen Upload behandeln. Video-Uploads sind asynchron, und erst ein status_code von FINISHED bestätigt, dass die Medien bereit sind.
- Veröffentlichen, während der Status IN_PROGRESS anzeigt. Der Aufruf schlägt mit Subcode 2207027 fehl, bis FINISHED erscheint.
- Einen Container länger als einen Tag halten. Nach 24 Stunden ohne Veröffentlichung zeigt er EXPIRED, und nur ein neuer Container kann veröffentlicht werden.
- Bei einem Fehler nur status_code lesen. Wenn dort ERROR steht, enthält das Feld status den Subcode, der die Ursache benennt.
Solange ein Video noch verarbeitet wird, schließt es die Veröffentlichung selbstständig ab. Claude, ChatGPT oder Ihr eigener Code erhalten die ID des veröffentlichten Mediums oder einen Verarbeitungsstatus, während easyCoexistence den Vorgang abschließt. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, mit sinkendem Preis je weiterer Verbindung, und 3 Tage kostenlose Testphase.
Häufig gestellte Fragen
Was bedeutet IN_PROGRESS bei einem Instagram-Container?
Meta bereitet die Medien noch vor. Warten und erneut prüfen, denn eine Veröffentlichung vor dem Status FINISHED schlägt mit Code 9007 fehl.
Wie viele Media-Container kann ein Instagram-Konto erstellen?
400 in einem gleitenden Zeitraum von 24 Stunden, was nach einem Fehler Raum lässt, einen Container erneut zu erstellen.
Was bedeutet config_issue nach der Veröffentlichung?
media_publish war erfolgreich, aber der Beitrag ging ohne seine Bildunterschrift, CAPTION_NOT_ATTACHED, oder ohne seine Nutzermarkierungen, USER_TAGGING_FAILURE, live.
Warum endete mein Container mit ERROR?
Er konnte den Veröffentlichungsprozess nicht abschließen. Sein Feld status enthält einen Fehler-Subcode mit dem Grund; die Ursache beheben und einen neuen Container erstellen.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am