So lesen Sie den status_code des Instagram-Containers vor dem Veröffentlichen

Was ist der status_code des Instagram-Containers?

Das Veröffentlichen auf Instagram über die API passiert in zwei Aufrufen, und der status_code des Instagram-Containers ist das Feld, das Ihnen sagt, ob der zweite Aufruf klappt. Der erste Aufruf erstellt mit POST /<IG_ID>/media einen Container. Der zweite veröffentlicht ihn mit POST /<IG_ID>/media_publish. Dazwischen sitzt ein asynchroner Transcode, den Sie nicht sehen, und Metas eigene Referenz sagt das offen: „Video uploads are asynchronous, so receiving a container ID does not guarantee that the upload was successful."

Das Feld lebt am Knoten IG Container. Meta definiert es als „The container's publishing status", und Sie lesen es mit einer einzigen Anfrage:

curl -X GET \
  'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

Was bedeutet jeder status_code-Wert?

Meta dokumentiert fünf Werte und keine weiteren. Die folgenden Definitionen stehen so in der IG-Container-Referenz und wiederholen sich Wort für Wort im Content-Publishing-Guide.

Zwei dieser fünf sind in dem Sinn endgültig, dass kein Warten sie noch ändert. ERROR und EXPIRED heißen beide, dass der Container in Ihrer Hand tot ist. FINISHED ist der einzige Wert, der los bedeutet.

Am selben Aufruf lohnt sich ein zweites Feld. copyright_check_status liefert matches_found als Boolean und einen eigenen status mit completed, error, in_progress oder not_started. Ein Reel kann bei status_code schon FINISHED erreichen, während die Urheberrechtsprüfung noch in_progress ist, und das ist einer der Gründe, warum ein scheinbar fertiger Publish trotzdem unzufrieden zurückkommt.

Wie oft empfiehlt Meta, den Container abzufragen?

Meta gibt einen einzigen Satz Orientierung: „We recommend querying a container's status once per minute, for no more than 5 minutes." Das sind fünf Anfragen, insgesamt, pro Container.

Die Zahl lohnt einen zweiten Blick, denn dieselbe Dokumentation setzt die Lebensdauer des Containers auf 24 Stunden. Fünf Minuten Abfragen decken rund 0,35 Prozent des Fensters ab, in dem der Container gültig ist. Meta sagt nie, was ein Client mit einem Container tun soll, der in Minute sechs noch IN_PROGRESS ist. Die Dokumentation hört schlicht auf.

In der Praxis ist ein langes Reel, das in Minute fünf noch transcodiert, weiterhin am Transcodieren, und der Container hält noch 23 Stunden und 55 Minuten. Die Fünf-Minuten-Decke liest sich als Rat dazu, wie hart man den Endpunkt anfassen darf, nicht als Aussage darüber, wann ein Container aussichtslos wird. Wer sie als Letzteres nimmt, wirft Container weg, die fertig geworden wären.

Wie lange hält ein Instagram-Container, bevor er abläuft?

Container laufen nach 24 Stunden ab. Die Referenz zu IG User Media sagt es in ihrer allgemeinen Liste der Einschränkungen, und die Definition von EXPIRED sagt es von der anderen Seite: Der Container „was not published within 24 hours."

Dieselbe Liste ergänzt eine zweite Zahl, die zählt, wenn Sie Beiträge in Menge einreihen: „An Instagram account can only create 400 containers within a rolling 24 hour period." Das ist ein Container-Budget, kein Publishing-Budget, und es zählt jeden Container, den Sie erstellen, ob Sie ihn je veröffentlichen oder nicht. Eine Retry-Schleife, die bei jedem Fehlschlag einen Container neu baut, brennt es schnell herunter.

Das Publishing-Budget ist eine eigene Zahl, und hier widerspricht Metas eigener Guide sich auf einer Seite selbst. Der Abschnitt Rate Limit im Content-Publishing-Guide sagt „Instagram accounts are limited to 100 API-published posts within a 24-hour moving period." Der Abschnitt Limitations zum Karussell, weiter unten auf derselben Seite, sagt „Accounts are limited to 50 published posts within a 24-hour period." Beide Sätze stehen live. Beide ergänzen, dass ein Karussell als ein Beitrag zählt. Wer dagegen baut, sollte GET /<IG_ID>/content_publishing_limit abfragen und dem mehr trauen als beiden Absätzen, und genau so gehen wir im Text zum Instagram Content Publishing Limit und zur Grenze von 100 Beiträgen pro 24 Stunden vor.

Was tun Sie, wenn status_code ERROR liefert?

Fragen Sie am selben Container das Feld status ab. Metas Definition dieses Feldes ist der nützliche Teil: „Publishing status. If status_code is ERROR, this value will be an error subcode."

status_code sagt Ihnen also, dass etwas kaputtging, und status sagt Ihnen, was. Die Subcodes, die an einem gescheiterten Container am häufigsten auftauchen, stammen aus Metas Tabelle der Instagram-Fehlercodes:

Der letzte ist der ehrliche. Metas empfohlene Lösung für 2207053 lautet „Generate a new container and use it to try again", und es steht dabei, der Subcode „should only affect video uploads."

Vier dieser sieben lassen sich beheben, bevor Sie überhaupt einen Container erstellen, indem Sie die Datei gegen die veröffentlichten Specs prüfen. Die Caption-Regeln behandelt der Text zum Caption-Limit von 2.200 Zeichen, die Video-Regeln die Aufschlüsselung dessen, was die Instagram Reels API annimmt.

Was tun Sie, wenn status_code EXPIRED liefert?

Von vorn anfangen. Es gibt keinen Endpunkt, der einen abgelaufenen Container wiederbelebt, keinen Verlängerungsparameter und überhaupt keine Update-Operation am Knoten. Die IG-Container-Referenz schreibt unter Creating, Updating und Deleting gleichermaßen „This operation is not supported". Ein Container ist von Ihrer Seite aus nur lesbar.

Metas Fehlertabelle bestätigt das Mittel in der Spalte der empfohlenen Lösung zu Subcode 2207020, dessen Meldung The media you are trying to access has expired. Please try to upload again. lautet. Der genannte Fix ist „Generate a new container ID and use it to try again."

Ein verwandter Subcode wird leicht mit Ablauf verwechselt und ist etwas anderes. Subcode 2207008 liefert The media builder with creation id = {creation-id} does not exist or has been expired. Meta nennt das einen „Temporary error publishing a container" und rät dazu, „Try again 1-2 times in the next 30 seconds to 2 minutes. If unsuccessful, generate a new container ID." Die Meldung sagt also abgelaufen, die Anleitung sagt erneut versuchen. Versuchen Sie es erneut, bevor Sie neu bauen.

Warum scheitert media_publish, wenn status_code FINISHED sagt?

Weil FINISHED den Container beschreibt, nicht das Konto. Drei Fehlschläge überleben ein sauberes FINISHED.

Subcode 2207027 liefert The media is not ready for publishing, please wait for a moment, und Metas Fix ist, den Container-Status zu prüfen und zu veröffentlichen, wenn dort FINISHED steht, was zirkulär ist, wenn FINISHED genau das ist, was Sie gerade gelesen haben. Behandeln Sie es als Wettlauf und versuchen Sie es erneut.

Subcode 2207042 liefert You reached maximum number of posts that is allowed to be published by Content Publishing API. Der Container ist in Ordnung, das Tageskontingent ist weg. Metas Rat lautet, „Advise the app's user to try again the following day."

Subcode 2207050 liefert The Instagram account is restricted. Meta erklärt, das Konto sei „is inactive, checkpointed, or restricted", und der einzige Weg nach vorn führt durch die Instagram-App, nicht durch die API. Das ist dieselbe Wand hinter den meisten Gründen, die Leute finden, wenn sie fragen, warum sie nicht auf Instagram posten können.

Häufig gestellte Fragen

Wie viele Werte kann status_code liefern?

Fünf. IN_PROGRESS, FINISHED, PUBLISHED, ERROR und EXPIRED. Metas IG-Container-Referenz führt genau diese auf und keine weiteren.

Muss ein Foto-Container überhaupt abgefragt werden?

Metas Troubleshooting-Abschnitt legt das Statusabfragen um Video herum an, da Bild-Container schon beim Erstellungsaufruf fertig sind. status_code an einem Bild-Container abzufragen funktioniert trotzdem und liefert weiterhin einen der fünf Werte.

Wie lange sollten Sie zwischen zwei Abfragen warten?

Eine Minute. Metas genauer Wortlaut ist „We recommend querying a container's status once per minute, for no more than 5 minutes."

Was passiert mit einem Container, den Sie nie veröffentlichen?

Er läuft 24 Stunden nach der Erstellung ab und zählt gegen die Grenze von 400 Containern pro rollenden 24 Stunden. Unveröffentlichte Container zählen nicht gegen das Publishing-Limit.

Können Sie einen Container löschen, um Kontingent frei zu machen?

Nein. Der Knoten IG Container führt Deleting als „This operation is not supported" auf. Container räumen sich selbst ab, wenn sie ablaufen.

Welches Feld sagt Ihnen, warum das Veröffentlichen fehlschlug?

Das Feld status, nicht status_code. Meta dokumentiert, dass der Wert von status ein Error-Subcode ist, wenn status_code auf ERROR steht, und den schlagen Sie dann in der Tabelle der Instagram-Fehlercodes nach.

Wie viele der ERROR-Subcodes lassen sich vermeiden, bevor Sie einen Container bauen?

Vier der sieben Subcodes in Metas Tabelle lassen sich vermeiden, bevor überhaupt ein Container existiert. Wer die Datei, ihre Maße und die Länge der Bildunterschrift vorab gegen Metas veröffentlichte Spezifikationen prüft, fängt ein falsches Videoformat, ein unpassendes Seitenverhältnis, ein zu großes Bild oder eine zu lange Bildunterschrift ab, bevor der Upload überhaupt beginnt, denn jede dieser Bedingungen ist schon vor dem Erstellen des Containers bekannt.

Kann ein Container FINISHED erreichen, bevor die Urheberrechtsprüfung fertig ist?

Ja. Ein Reel kann bei status_code FINISHED erreichen, während copyright_check_status noch in_progress ist, sodass der Container fertig wirkt, obwohl die Urheberrechtsprüfung noch läuft. Dieses Feld liefert matches_found als Boolean und einen Status von completed, error, in_progress oder not_started, den Sie am besten zusammen mit status_code abfragen, bevor Sie veröffentlichen.

Warum widersprechen sich Metas eigene Angaben zum Veröffentlichungslimit?

Der Abschnitt Rate Limit im Content Publishing Guide begrenzt Konten auf 100 über die API veröffentlichte Beiträge innerhalb eines gleitenden 24-Stunden-Zeitraums, während der weiter unten auf derselben Seite stehende Abschnitt Limitations für Karussells von 50 veröffentlichten Beiträgen innerhalb von 24 Stunden spricht. Beide Aussagen stehen weiterhin so in Metas Dokumentation. Wer stattdessen GET /<IG_ID>/content_publishing_limit abfragt und dieser Antwort mehr vertraut als den beiden Textstellen, umgeht das Rätselraten.

Bedeutet der Subcode 2207008, dass der Container abgelaufen ist?

Nein, auch wenn die Meldung "has been expired" lautet. Meta stuft 2207008 als vorübergehenden Fehler ein und empfiehlt, es ein- oder zweimal innerhalb von 30 Sekunden bis 2 Minuten erneut zu versuchen, bevor ein neuer Container entsteht. Ein tatsächlicher EXPIRED-Status dagegen bietet keine Möglichkeit für einen erneuten Versuch.