TL;DR, szybka odpowiedź
7 min czytaniaMeta opisuje dokładnie pięć wartości status_code kontenera na Instagramie: IN_PROGRESS, FINISHED, PUBLISHED, ERROR i EXPIRED, i zaleca odpytywanie "once per minute, for no more than 5 minutes." Kontenery wygasają po 24 godzinach, więc zalecane okno odpytywania obejmuje mniej niż pół procenta życia kontenera. Przy ERROR odczytaj pole status kontenera, które według Mety zawiera podkod błędu. Przy EXPIRED jedynym rozwiązaniem jest nowy kontener.
Czym jest status_code kontenera na Instagramie?
Publikacja na Instagramie przez API odbywa się w dwóch wywołaniach, a status_code kontenera to pole, które mówi, czy drugie z nich się powiedzie. Pierwsze wywołanie tworzy kontener za pomocą POST /<IG_ID>/media. Drugie publikuje go przez POST /<IG_ID>/media_publish. Między nimi trwa asynchroniczne transkodowanie, którego nie widzisz, a dokumentacja Mety mówi o tym wprost: "Video uploads are asynchronous, so receiving a container ID does not guarantee that the upload was successful."
Pole należy do węzła IG Container. Meta definiuje je jako "The container's publishing status", a odczytasz je jednym żądaniem:
curl -X GET \
'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'{
"status_code": "FINISHED",
"id": "17889615691921648"
}Co oznacza każda wartość status_code?
Meta opisuje pięć wartości i żadnych innych. Poniższe definicje pochodzą z dokumentacji IG Container i powtarzają się słowo w słowo w przewodniku Content Publishing.
| Wartość | Definicja Mety | Co robisz |
|---|---|---|
IN_PROGRESS | "The container is still in the publishing process." | Czekasz i odpytujesz znów |
FINISHED | "The container and its media object are ready to be published." | Wywołujesz media_publish |
PUBLISHED | "The container's media object has been published." | Przestajesz odpytywać |
ERROR | "The container failed to complete the publishing process." | Odczytujesz pole status |
EXPIRED | "The container was not published within 24 hours and has expired." | Tworzysz nowy kontener |
Dwie z tych pięciu wartości są ostateczne w tym sensie, że żadne czekanie ich nie zmieni. ERROR i EXPIRED oznaczają, że kontener, który masz, jest martwy. FINISHED to jedyna wartość, która daje zielone światło.
W tym samym wywołaniu warto poprosić o drugie pole. copyright_check_status zwraca matches_found jako wartość logiczną oraz własny status: completed, error, in_progress lub not_started. Rolka może osiągnąć FINISHED w status_code, gdy sprawdzanie praw autorskich jest jeszcze in_progress, i to jeden z powodów, dla których publikacja wyglądająca na gotową nadal może się nie udać.

Jak często Meta zaleca odpytywać kontener?
Meta daje jedno zdanie wskazówek: "We recommend querying a container's status once per minute, for no more than 5 minutes." To łącznie pięć żądań na kontener.
Tej liczbie warto się przyjrzeć, bo ta sama dokumentacja ustala czas życia kontenera na 24 godziny. Pięć minut odpytywania obejmuje około 0,35% okresu, w którym kontener jest ważny. Meta nigdy nie mówi, co klient ma zrobić z kontenerem, który w szóstej minucie nadal ma IN_PROGRESS. Dokumentacja po prostu w tym miejscu się kończy.
W praktyce długa rolka, która wciąż się transkoduje w piątej minucie, dalej się transkoduje, a kontener zachowuje ważność przez kolejne 23 godziny i 55 minut. Pięciominutowy limit wygląda raczej na radę, jak mocno obciążać endpoint, niż na stwierdzenie, kiedy kontener staje się beznadziejny. Traktując go w ten drugi sposób, wyrzucasz kontenery, które by się zakończyły.
Jak długo kontener na Instagramie działa, zanim wygaśnie?
Kontenery wygasają po 24 godzinach. Dokumentacja IG User Media podaje to na ogólnej liście ograniczeń, a definicja EXPIRED powtarza to z drugiej strony: kontener "was not published within 24 hours."
Ta sama lista zawiera drugą liczbę, ważną przy masowym ustawianiu postów w kolejce: "An Instagram account can only create 400 containers within a rolling 24 hour period." To budżet kontenerów, a nie publikacji, i obejmuje każdy utworzony kontener, niezależnie od tego, czy kiedykolwiek go opublikujesz. Pętla ponawiania, która przy każdym błędzie tworzy kontener od nowa, szybko go wyczerpie.
Budżet publikacji to osobna liczba i tu przewodnik Mety przeczy sam sobie na jednej stronie. Sekcja Rate Limit przewodnika Content Publishing mówi "Instagram accounts are limited to 100 API-published posts within a 24-hour moving period." Sekcja Limitations dotycząca karuzel, niżej na tej samej stronie, mówi "Accounts are limited to 50 published posts within a 24-hour period." Oba zdania są aktualne. Oba dodają, że karuzela liczy się jako jeden post. Budując integrację, warto odpytać GET /<IG_ID>/content_publishing_limit i ufać tej odpowiedzi bardziej niż któremukolwiek akapitowi. Takie podejście opisujemy w tekstach o limicie publikacji treści na Instagramie i o limicie 100 postów na 24 godziny.

Co zrobić, gdy status_code zwraca ERROR?
Poproś o pole status tego samego kontenera. Najbardziej przydatna jest definicja Mety: "Publishing status. If status_code is ERROR, this value will be an error subcode."
status_code mówi więc, że coś się zepsuło, a status mówi co. Podkody najczęściej pojawiające się przy nieudanym kontenerze pochodzą z tabeli kodów błędów Instagrama opublikowanej przez Metę:
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
| Podkod | Komunikat zwracany przez Metę | Przyczyna |
|---|---|---|
2207026 | The video format is not supported. Please check spec for supported {video} format | Inny format niż MOV lub MP4 |
2207009 | The submitted image with aspect ratio {submitted-ratio} cannot be published. | Poza zakresem 4:5 do 1.91:1 |
2207004 | The image is too large to download. It should be less than {size}. | Ponad 8 MiB |
2207010 | The submitted image's caption was {submitted-caption-length} characters long. | Ponad 2 200 znaków |
2207052 | The media could not be fetched from this uri: {uri} | URL niedostępny publicznie |
2207003 | It takes too long to download the media. | Przekroczony czas pobierania |
2207053 | unknown upload error | Nieudane przesyłanie wideo |
Ostatni kod jest najszczerszy. Rozwiązanie zalecane przez Metę dla 2207053 to "Generate a new container and use it to try again", a dokumentacja zaznacza, że podkod "should only affect video uploads."
Cztery z tych siedmiu błędów można wyeliminować, zanim w ogóle utworzysz kontener, sprawdzając plik pod kątem opublikowanych specyfikacji. Zasady dotyczące opisów omawiamy w tekście o limicie 2 200 znaków w opisie, a zasady dotyczące wideo w omówieniu tego, co przyjmuje API Instagram Reels.
Co zrobić, gdy status_code zwraca EXPIRED?
Zacznij od nowa. Nie ma endpointu, który przywraca wygasły kontener, parametru przedłużającego ani żadnej operacji aktualizacji tego węzła. Dokumentacja IG Container przy tworzeniu, aktualizacji i usuwaniu podaje to samo: "This operation is not supported". Z twojej strony kontener można tylko odczytać.
Tabela błędów Mety potwierdza to w kolumnie z zalecanym rozwiązaniem dla podkodu 2207020, którego komunikat brzmi The media you are trying to access has expired. Please try to upload again. Podane rozwiązanie to "Generate a new container ID and use it to try again."
Łatwo pomylić z wygaśnięciem pokrewny podkod, który oznacza co innego. Podkod 2207008 zwraca The media builder with creation id = {creation-id} does not exist or has been expired. Meta nazywa to "Temporary error publishing a container" i radzi "Try again 1-2 times in the next 30 seconds to 2 minutes. If unsuccessful, generate a new container ID." Komunikat mówi więc o wygaśnięciu, a zalecenie o ponowieniu. Ponów, zanim zbudujesz kontener od nowa.
Dlaczego media_publish zawodzi, gdy status_code to FINISHED?
Bo FINISHED opisuje kontener, a nie konto. Trzy rodzaje błędów mogą wystąpić mimo czystego FINISHED.
Podkod 2207027 zwraca The media is not ready for publishing, please wait for a moment, a rozwiązanie Mety to sprawdzić status kontenera i opublikować, gdy pokaże FINISHED, co jest błędnym kołem, skoro właśnie taką wartość odczytano. Potraktuj to jak wyścig i ponów próbę.
Podkod 2207042 zwraca You reached maximum number of posts that is allowed to be published by Content Publishing API. Kontener jest w porządku, wyczerpał się dzienny limit. Meta radzi: "Advise the app's user to try again the following day."
Podkod 2207050 zwraca The Instagram account is restricted. Meta wyjaśnia, że konto "is inactive, checkpointed, or restricted", a jedyna droga naprzód prowadzi przez aplikację Instagram, a nie API. To ta sama ściana, która stoi za większością powodów, gdy ktoś pyta, dlaczego nie może publikować na Instagramie.
Najczęściej zadawane pytania
Ile wartości może zwrócić status_code?
Pięć: IN_PROGRESS, FINISHED, PUBLISHED, ERROR i EXPIRED. Dokumentacja IG Container wymienia dokładnie te i żadnych innych.
Czy kontener ze zdjęciem w ogóle trzeba odpytywać?
Sekcja rozwiązywania problemów Mety wiąże odpytywanie statusu z wideo, bo kontenery obrazów rozstrzygają się przy wywołaniu tworzącym. Zapytanie o status_code kontenera obrazu nadal działa i zwraca jedną z pięciu wartości.
Ile czekać między kolejnymi zapytaniami?
Minutę. Dokładne sformułowanie Mety to "We recommend querying a container's status once per minute, for no more than 5 minutes."
Co się dzieje z kontenerem, którego nigdy nie opublikujesz?
Wygasa 24 godziny po utworzeniu i wlicza się do limitu 400 kontenerów w kroczącym okresie 24 godzin. Nieopublikowane kontenery nie wliczają się do limitu publikacji.
Czy można usunąć kontener, aby zwolnić limit?
Nie. Węzeł IG Container przy usuwaniu podaje "This operation is not supported." Kontenery znikają same po wygaśnięciu.
Które pole mówi, dlaczego publikacja się nie udała?
Pole status, a nie status_code. Meta podaje, że gdy status_code to ERROR, wartość status jest podkodem błędu, który sprawdzasz w tabeli kodów błędów Instagrama.
AdaptlyPost
Rozpocznij 7-dniowy bezpłatny okres próbny
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Ilu podkodom ERROR można zapobiec przed utworzeniem kontenera?
Czterech z siedmiu podkodów z tabeli Mety można uniknąć, zanim kontener w ogóle powstanie. Sprawdzenie pliku, jego wymiarów i długości opisu względem specyfikacji Mety wyłapie zły format wideo, proporcje poza zakresem, zbyt duży obraz lub za długi opis, bo każdy z tych warunków znasz przed utworzeniem kontenera.
Czy kontener może osiągnąć FINISHED przed zakończeniem sprawdzania praw autorskich?
Tak. Rolka może mieć FINISHED w status_code, gdy copyright_check_status jest jeszcze in_progress, więc kontener wygląda na gotowy, zanim sprawdzanie praw autorskich faktycznie się zakończy. To pole zwraca matches_found jako wartość logiczną oraz status completed, error, in_progress lub not_started, i warto prosić o nie razem ze status_code przed publikacją.
Dlaczego dokumentacja Mety przeczy sama sobie w sprawie limitu publikacji?
Sekcja Rate Limit przewodnika Content Publishing ogranicza konta do 100 postów opublikowanych przez API w ruchomym okresie 24 godzin, a sekcja Limitations dotycząca karuzel, niżej na tej samej stronie, podaje limit 50 opublikowanych postów w ciągu 24 godzin. Oba zdania nadal są w dokumentacji Mety. Odpytanie GET /<IG_ID>/content_publishing_limit i zaufanie tej odpowiedzi zamiast któregokolwiek akapitu pozwala uniknąć zgadywania.
Czy podkod 2207008 oznacza, że kontener wygasł?
Nie, choć jego komunikat brzmi "has been expired." Meta klasyfikuje 2207008 jako błąd tymczasowy i zaleca jedną lub dwie ponowne próby w ciągu kolejnych 30 sekund do 2 minut, zanim zbudujesz nowy kontener. Prawdziwy status EXPIRED w ogóle nie daje możliwości ponowienia.
Wykorzystaj to w praktyce z AdaptlyPost
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Więcej naszych treści w Google
Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.
Jeszcze chwila...
AdaptlyPost
Planowanie treści na wszystkich platformach
Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.
Analityka wszystkich platform
Skrzynka społecznościowa
Asystent oparty na AI
Powiązane hasła ze słownika


Co zwraca endpoint content_publishing_limit na Instagramie
Endpoint content_publishing_limit na Instagramie zwraca quota_usage oraz blok config z wartościami quota_total 50 i quota_duration 86400 sekund.


Jak działa limit 100 postów na 24 godziny w API Instagrama
Limit 100 postów na 24 godziny w API Instagrama to ruchome okno liczone przy publikacji. Karuzela liczy się raz, a zdanie o 50 postach pozostaje niewyjaśnione.


Dlaczego dzienny limit postów na Instagramie to w dokumentacji Mety 100 i 50
Instagram nie podaje dziennego limitu postów dla aplikacji. Dokumentacja API Mety mówi raz o 100 postach na 24 godziny, a dwa razy o 50. Sprawdź, co obowiązuje.
Powiązane artykuły


Co liczą interakcje z treściami na Instagramie, a co odejmują
Interakcje z treściami na Instagramie w praktyce: metryka Interakcje, pole API total_interactions, powody spadku liczby i to, kiedy wliczane są reklamy.


Dlaczego narzędzie do planowania postów ciągle rozłącza konta
Narzędzie do planowania rozłącza konta, gdy token wygasa lub ginie przedwcześnie. Czas życia tokenów Meta, LinkedIna, X i TikToka oraz to, co je unieważnia.


Długoterminowy token dostępu Facebooka i jego 60-dniowy zegar
Długoterminowy token dostępu Facebooka działa około 60 dni, a uzyskany z niego token strony nie ma daty wygaśnięcia. Wywołanie wymiany i najważniejsze zastrzeżenia.

