Słownik

Jak odczytać status_code kontenera na Instagramie przed publikacją

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •7 min czytania
Jak odczytać status_code kontenera na Instagramie przed publikacjąJak odczytać status_code kontenera na Instagramie przed publikacją

TL;DR, szybka odpowiedź

7 min czytania

Meta 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 MetyCo 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ć.

Telefon na biurku z animacją ładowania, symbolizującą oczekiwanie na transkodowanie kontenera wideo.

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.

Okno odpytywania a czas życia kontenera
Zalecane okno odpytywania5 min
Czas życia kontenera do wygaśnięcia24 godz.
Pięciominutowe zalecenie Mety obejmuje ułamek 24 godzin, przez które kontener pozostaje ważny.

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.

Osoba przy laptopie patrzy na komunikat o błędzie podczas edycji pliku wideo, co oddaje pracę, jakiej wymaga status_code ERROR.

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
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

PodkodKomunikat zwracany przez MetęPrzyczyna
2207026The video format is not supported. Please check spec for supported {video} formatInny format niż MOV lub MP4
2207009The submitted image with aspect ratio {submitted-ratio} cannot be published.Poza zakresem 4:5 do 1.91:1
2207004The image is too large to download. It should be less than {size}.Ponad 8 MiB
2207010The submitted image's caption was {submitted-caption-length} characters long.Ponad 2 200 znaków
2207052The media could not be fetched from this uri: {uri}URL niedostępny publicznie
2207003It takes too long to download the media.Przekroczony czas pobierania
2207053unknown upload errorNieudane 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
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.

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

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

Powiązane artykuły