Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Status kontenera mediów Instagram: kody i cykl życia

API Instagrama publikuje przez kontenery mediów, a każdy z nich zwraca status_code: IN_PROGRESS, gdy jest jeszcze w trakcie publikacji, FINISHED, gdy jest gotowy, PUBLISHED, gdy jest już opublikowany, ERROR, gdy nie udało się go ukończyć, oraz EXPIRED, gdy minęło 24 godziny bez publikacji. Meta zaleca sprawdzanie raz na minutę, przez nie dłużej niż 5 minut.

easyCoexistence prowadzi cykl kontenera wewnątrz publish_instagram_post: tworzy kontener, czeka, aż Instagram skończy, i publikuje.

5

Wartości, jakie może przyjmować status_code: IN_PROGRESS, FINISHED, PUBLISHED, ERROR i EXPIRED.

24 hours

Jak długo kontener może czekać na publikację, zanim jego status zmieni się na EXPIRED.

1 min

Zalecany przez Meta odstęp między sprawdzeniami statusu, przez nie dłużej niż 5 minut.

400

Kontenery, które konto Instagram może utworzyć w ciągu kroczących 24 godzin.

2207027

Podkod błędu w ramach kodu 9007 przy publikacji kontenera, który nie jest jeszcze gotowy.

Czym jest kontener mediów?

Obiekt, z którego publikowany jest post. POST /<IG_ID>/media tworzy go z adresu URL obrazu lub wideo, Meta pobiera i przygotowuje media, a POST /<IG_ID>/media_publish z identyfikatorem kontenera jako creation_id zamienia go w post. Karuzela dodaje jeszcze jeden poziom: osobny kontener dla każdego elementu, a następnie kontener CAROUSEL, który je wymienia jako elementy podrzędne.

Co oznacza każdy kod statusu?

GET /<IG_CONTAINER_ID>?fields=status_code zwraca jedną z pięciu wartości, z których każda ma własny kolejny krok:

  • IN_PROGRESS: kontener nadal jest w trakcie publikacji; poczekaj i sprawdź ponownie.
  • FINISHED: kontener i jego media są gotowe; opublikuj go.
  • PUBLISHED: media są już opublikowane; nie trzeba nic więcej publikować.
  • ERROR: kontener nie zdołał ukończyć publikacji; pole status zawiera podkod błędu z przyczyną, a potrzebny jest nowy kontener.
  • EXPIRED: nie został opublikowany w ciągu 24 godzin; utwórz nowy.
Checking a container's status
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code

{
  "status_code": "FINISHED",
  "id": "<IG_CONTAINER_ID>"
}

Jak często sprawdzać status?

Raz na minutę, przez nie dłużej niż 5 minut, to zalecenie Meta. Najbardziej się to liczy przy wideo, ponieważ Meta zaznacza, że przesyłanie wideo jest asynchroniczne: otrzymanie identyfikatora kontenera nie gwarantuje, że przesyłanie się udało, a dopiero status_code FINISHED to potwierdza.

Co się dzieje, gdy opublikujesz za wcześnie?

media_publish kończy się niepowodzeniem z kodem 9007 i podkodem 2207027: media nie są gotowe do publikacji. Żądania nie trzeba poprawiać; sprawdź status i opublikuj dopiero, gdy pokaże FINISHED. Kod 24 z podkodem 2207008 to coś innego: kontener, który nie istnieje lub wygasł. Meta sugeruje ponowić próbę raz lub dwa razy w odstępach od 30 sekund do 2 minut, zanim utworzysz nowy kontener.

Jak długo żyje kontener?

24 godziny. Kontener, który nie zostanie opublikowany w tym czasie, ma status EXPIRED i nie można go już opublikować. Kod -2 z podkodem 2207020, czyli media wygasły, również wymaga nowego kontenera. Konto może utworzyć 400 kontenerów w ciągu kroczących 24 godzin, co pozwala na ponowne utworzenie jednego po niepowodzeniu.

Co jeszcze zwraca kontener?

Dwa dodatkowe pola i uwaga dotycząca publikacji. Pole status zawiera podkod błędu zawsze, gdy status_code ma wartość ERROR. copyright_check_status informuje przy wideo, czy sprawdzenie praw autorskich Meta zostało uruchomione i czy znalazło dopasowania. Po publikacji media_publish może zwrócić config_issue, CAPTION_NOT_ATTACHED lub USER_TAGGING_FAILURE, gdy post został opublikowany bez podpisu lub bez oznaczeń użytkowników.

Typowe błędy

  • Traktowanie identyfikatora kontenera jak zakończonego przesyłania. Przesyłanie wideo jest asynchroniczne, a tylko status_code FINISHED potwierdza, że media są gotowe.
  • Publikowanie, gdy status pokazuje IN_PROGRESS. Wywołanie kończy się niepowodzeniem z podkodem 2207027, dopóki status nie pokaże FINISHED.
  • Trzymanie kontenera dłużej niż dobę. Po 24 godzinach bez publikacji ma status EXPIRED i można opublikować tylko nowy kontener.
  • Czytanie samego status_code przy niepowodzeniu. Gdy pokazuje ERROR, pole status przenosi podkod wskazujący przyczynę.
Z EasyCoexistence zrobisz to

Gdy wideo jest jeszcze przetwarzane, samo kończy publikację. Claude, ChatGPT lub Twój własny kod dostaje z powrotem identyfikator opublikowanego medium albo status przetwarzania, dopóki easyCoexistence to kończy. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami bezpłatnego okresu próbnego.

Najczęściej zadawane pytania

Co oznacza IN_PROGRESS w kontenerze Instagram?

Meta nadal przygotowuje media. Poczekaj i sprawdź ponownie, ponieważ publikacja przed statusem FINISHED kończy się niepowodzeniem z kodem 9007.

Ile kontenerów mediów może utworzyć konto Instagram?

400 w ciągu kroczących 24 godzin, co pozwala utworzyć kontener ponownie po niepowodzeniu.

Co oznacza config_issue po publikacji?

media_publish się powiodło, ale post został opublikowany bez podpisu, CAPTION_NOT_ATTACHED, albo bez oznaczeń użytkowników, USER_TAGGING_FAILURE.

Dlaczego mój kontener zakończył się statusem ERROR?

Nie udało mu się ukończyć publikacji. Pole status zawiera podkod błędu z przyczyną; usuń tę przyczynę i utwórz nowy kontener.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w