ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Κατάσταση του media container στο Instagram: οι κωδικοί και ο κύκλος ζωής

Το API του Instagram δημοσιεύει μέσω των media containers, και καθένα αναφέρει ένα status_code: IN_PROGRESS όσο βρίσκεται ακόμα στη διαδικασία δημοσίευσης, FINISHED όταν είναι έτοιμο, PUBLISHED μόλις είναι ζωντανό, ERROR αν απέτυχε να ολοκληρωθεί και EXPIRED αν πέρασαν 24 ώρες χωρίς δημοσίευση. Η Meta προτείνει έλεγχο μία φορά το λεπτό, για το πολύ 5 λεπτά.

Το easyCoexistence εκτελεί τον κύκλο των containers μέσα στο publish_instagram_post: δημιουργεί το container, περιμένει το Instagram να ολοκληρώσει και δημοσιεύει.

5

Τιμές που μπορεί να πάρει το status_code: IN_PROGRESS, FINISHED, PUBLISHED, ERROR και EXPIRED.

24 hours

Πόση ώρα μπορεί ένα container να μείνει αδημοσίευτο προτού η κατάστασή του γίνει EXPIRED.

1 min

Το προτεινόμενο διάστημα της Meta ανάμεσα στους ελέγχους κατάστασης, για το πολύ 5 λεπτά.

400

Τα containers που μπορεί να δημιουργήσει ένας λογαριασμός Instagram σε κυλιόμενο 24ωρο.

2207027

Ο υποκωδικός σφάλματος κάτω από τον κωδικό 9007, για δημοσίευση container που δεν είναι ακόμα έτοιμο.

Τι είναι ένα media container;

Το αντικείμενο από το οποίο δημοσιεύεται μια ανάρτηση. Το POST /<IG_ID>/media δημιουργεί ένα από URL εικόνας ή βίντεο, η Meta λαμβάνει και προετοιμάζει το media, και το POST /<IG_ID>/media_publish με το ID του container ως creation_id το μετατρέπει σε ανάρτηση. Το carousel προσθέτει ένα επίπεδο: ένα container για κάθε στοιχείο, και μετά ένα container τύπου CAROUSEL που τα περιλαμβάνει ως θυγατρικά του.

Τι σημαίνει κάθε κωδικός κατάστασης;

Το GET /<IG_CONTAINER_ID>?fields=status_code επιστρέφει μία από πέντε τιμές, καθεμία με το δικό της επόμενο βήμα:

  • IN_PROGRESS: το container βρίσκεται ακόμα στη διαδικασία δημοσίευσης. Περιμένετε και ελέγξτε ξανά.
  • FINISHED: το container και το media του είναι έτοιμα. Δημοσιεύστε το.
  • PUBLISHED: το media είναι ήδη ζωντανό, και δεν μένει τίποτα να δημοσιευθεί.
  • ERROR: το container απέτυχε να ολοκληρώσει τη διαδικασία δημοσίευσης. Το πεδίο status περιέχει έναν υποκωδικό σφάλματος με την αιτία, και χρειάζεται νέο container.
  • EXPIRED: δεν δημοσιεύτηκε μέσα σε 24 ώρες. Δημιουργήστε ένα νέο container.
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 επισημαίνει ότι τα ανεβάσματα βίντεο είναι ασύγχρονα: η λήψη του ID ενός container δεν εγγυάται ότι το ανέβασμα πέτυχε, και μόνο ένα status_code FINISHED το επιβεβαιώνει.

Τι συμβαίνει αν δημοσιεύσετε πολύ νωρίς;

Το media_publish αποτυγχάνει με κωδικό 9007, υποκωδικό 2207027: το media δεν είναι έτοιμο για δημοσίευση. Στο αίτημα δεν χρειάζεται διόρθωση· ελέγξτε την κατάσταση και δημοσιεύστε μόλις η κατάσταση γίνει FINISHED. Ο κωδικός 24 με υποκωδικό 2207008 είναι διαφορετικός, αφορά ένα container που δεν υπάρχει ή έχει λήξει, και η Meta προτείνει να δοκιμάσετε ξανά μία ή δύο φορές, μέσα σε 30 δευτερόλεπτα έως 2 λεπτά, πριν δημιουργήσετε νέο container.

Πόση ώρα διαρκεί ένα container;

24 ώρες. Ένα container που δεν δημοσιεύεται μέσα σε αυτό το διάστημα γίνεται EXPIRED και δεν μπορεί πια να δημοσιευθεί. Ο κωδικός -2 με υποκωδικό 2207020, που σημαίνει ότι το media έχει λήξει, ζητά επίσης νέο container. Ένας λογαριασμός μπορεί να δημιουργήσει 400 containers σε κυλιόμενο 24ωρο, που αφήνει χώρο για να δημιουργήσετε ξανά ένα container μετά από αποτυχία.

Τι άλλο αναφέρει ένα container;

Δύο ακόμα πεδία, και μια σημείωση για τη δημοσίευση. Το πεδίο status περιέχει έναν υποκωδικό σφάλματος κάθε φορά που το status_code γράφει ERROR. Το copyright_check_status δείχνει, για ένα βίντεο, αν έχει τρέξει ο έλεγχος πνευματικών δικαιωμάτων της Meta και αν βρήκε αντιστοιχίες. Μετά τη δημοσίευση, το media_publish μπορεί να επιστρέψει config_issue, CAPTION_NOT_ATTACHED ή USER_TAGGING_FAILURE, όταν η ανάρτηση δημοσιεύτηκε χωρίς τη λεζάντα ή τις ετικέτες χρηστών της.

Συνηθισμένα λάθη

  • Το να θεωρείτε ότι το ID ενός container είναι ολοκληρωμένο ανέβασμα. Τα ανεβάσματα βίντεο είναι ασύγχρονα, και μόνο ένα status_code FINISHED επιβεβαιώνει ότι το media είναι έτοιμο.
  • Δημοσίευση όσο η κατάσταση είναι IN_PROGRESS. Η κλήση αποτυγχάνει με υποκωδικό 2207027, μέχρι η κατάσταση να γίνει FINISHED.
  • Κράτημα ενός container πάνω από μία μέρα. Μετά από 24 ώρες χωρίς δημοσίευση γίνεται EXPIRED, και μόνο ένα νέο container μπορεί να δημοσιευθεί.
  • Η ανάγνωση μόνο του status_code σε αποτυχία. Όταν γράφει ERROR, το πεδίο status περιέχει τον υποκωδικό που δείχνει την αιτία.
Κάντε το με EasyCoexistence

Όσο ένα βίντεο ακόμα επεξεργάζεται, ολοκληρώνει τη δημοσίευση από μόνο του. Ο Claude, το ChatGPT ή ο δικός σας κώδικας παίρνουν πίσω το ID του δημοσιευμένου media ή μια κατάσταση επεξεργασίας όσο το easyCoexistence το ολοκληρώνει. Από US$ 9 έως US$ 0.75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Τι σημαίνει το IN_PROGRESS σε ένα container του Instagram;

Η Meta εξακολουθεί να προετοιμάζει το media. Περιμένετε και ελέγξτε ξανά, καθώς η δημοσίευση πριν η κατάσταση γίνει FINISHED αποτυγχάνει με κωδικό 9007.

Πόσα media containers μπορεί να δημιουργήσει ένας λογαριασμός Instagram;

400 σε κυλιόμενο 24ωρο, που αφήνει χώρο για να δημιουργήσετε ξανά ένα container μετά από αποτυχία.

Τι σημαίνει το config_issue μετά τη δημοσίευση;

Το media_publish ολοκληρώθηκε, αλλά η ανάρτηση δημοσιεύτηκε χωρίς λεζάντα (CAPTION_NOT_ATTACHED) ή χωρίς ετικέτες χρηστών (USER_TAGGING_FAILURE).

Γιατί το container σας κατέληξε σε ERROR;

Απέτυχε να ολοκληρώσει τη διαδικασία δημοσίευσης. Το πεδίο status περιέχει έναν υποκωδικό σφάλματος με την αιτία. Διορθώστε αυτή την αιτία και δημιουργήστε ένα νέο container.

Συνεχίστε την ανάγνωση

Προγραμματισμός αναρτήσεων Instagram μέσω του APIΟι προγραμματισμένες αναρτήσεις Instagram μέσω API: μια ουρά κρατά κάθε ανάρτηση και τη δημοσιεύει την ώρα της, με τα media σε δημόσιο URL.Ορισμός του εξωφύλλου Reel μέσω του Instagram APIΟρισμός εξωφύλλου Instagram Reel μέσω του API: JPEG με cover_url ή καρέ βίντεο με thumb_offset, προδιαγραφές Meta και περικοπή εξωφύλλων.Δημοσίευση Instagram Reels μέσω του APIΠώς το API του Instagram δημοσιεύει Reels: οι απαιτήσεις βίντεο της Meta, τα containers, ο χρόνος επεξεργασίας, η κοινοποίηση στο Feed και οι μετρήσεις.Όρια δημοσίευσης στο Instagram API: μορφές, μεγέθη και αναρτήσεις ανά ημέραΌρια δημοσίευσης στο Instagram API: JPEG έως 8 MB, Reels, Stories, λεζάντες έως 2.200 χαρακτήρων και 100 αναρτήσεις ανά 24 ώρες.Σφάλματα του Instagram API: τι σημαίνουν οι συνηθισμένοι κωδικοίΣυνηθισμένα σφάλματα του Instagram API: ληγμένα token, όρια ρυθμού, πολυμέσα που η Meta δεν φορτώνει, όριο δημοσιεύσεων και κλειστά παράθυρα DM.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις