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

Błędy Instagram API: co oznaczają najczęstsze kody

Najczęstsze błędy Instagram API to 190 przy wygasłym lub nieprawidłowym tokenie, 4, 17 i 80002 przy limitach żądań, 9004 dla mediów, których Meta nie może pobrać, 9007 dla wideo, które wciąż się przetwarza, 9 przy dziennym limicie publikacji oraz 10 z podkodem 2534022 dla DM wysłanego poza oknem wiadomości. Każdy błąd przychodzi jako JSON z kodem, często z podkodem wskazującym dokładny przypadek, oraz komunikatem.

easyCoexistence zajmuje się stroną połączenia tych błędów: odnawia dostęp do Instagrama przed jego wygaśnięciem, sprawdza konto co 6 godzin i wysyła e-mail, gdy trzeba je połączyć ponownie.

190

Kod Graph API dla tokenu dostępu, który wygasł, został unieważniony lub jest w inny sposób nieprawidłowy.

80002

Kod błędu dla limitu wywołań Business Use Case w Instagramie.

2207042

Podkod pod kodem 9 dla konta, które osiągnęło dzienny limit publikacji przez API.

2207052

Podkod pod kodem 9004 dla mediów, których Meta nie mogła pobrać z podanego URL.

2534041

Podkod pod kodem 200, gdy konto wyłączyło dostęp do swoich wiadomości na Instagramie.

Jak czytać błąd Instagram API?

Każdy błąd jest obiektem JSON w polu error. code to szeroka kategoria, error_subcode wskazuje konkretny przypadek i zwykle jest z tej dwójki bardziej przydatny, a message go opisuje. Wiele błędów zawiera także error_user_title i error_user_msg, czyli tekst przeznaczony dla użytkownika, oraz is_transient. fbtrace_id identyfikuje żądanie w pomocy technicznej Meta i szybko wygasa, dlatego zapisz go w logach w chwili wystąpienia błędu.

Co oznaczają błędy dostępu i uprawnień?

Błędy dotyczące tego, kto może co zrobić, wraz z poprawką dla każdego:

  • 190: token dostępu wygasł, został unieważniony lub jest w inny sposób nieprawidłowy; podkod 463 oznacza wygaśnięcie, 467 nieprawidłowy token, a 460 zmianę hasła. Nowy token naprawia sprawę, a w przypadku połączonego konta oznacza to ponowne połączenie.
  • 10: odmowa uprawnień. Uprawnienie nigdy nie zostało przyznane albo zostało później odebrane.
  • 200–299: brakuje konkretnego uprawnienia, na przykład 200 z podkodem 2534041, gdy konto wyłączyło dostęp do swoich wiadomości.
  • 25, podkod 2207050: konto jest ograniczone, nieaktywne lub objęte weryfikacją bezpieczeństwa (checkpoint); właściciel musi zalogować się w aplikacji Instagram i wykonać to, o co aplikacja prosi.

Co oznaczają błędy limitów żądań?

Ograniczanie przepustowości, i wszystko to jest tymczasowe:

  • 4: zbyt wiele wywołań z aplikacji; poczekaj i ponów próbę albo zmniejsz liczbę żądań.
  • 17: zbyt wiele wywołań dla użytkownika; obowiązuje to samo rozwiązanie.
  • 80002: limit Business Use Case Instagrama, wyliczany dla każdej aplikacji i konta na podstawie wyświetleń konta: 4 800 wywołań na wyświetlenie w ciągu 24 godzin.
  • 613, podkod 2534040: zbyt wiele wywołań związanych z wiadomościami; wstrzymaj się i spróbuj ponownie później.

Co oznaczają błędy publikacji dotyczące mediów?

Błędy dotyczące pliku i miejsca jego hostowania; tylko przekroczenie czasu warto ponowić w obecnym stanie:

  • 9004, podkod 2207052: Meta nie mogła pobrać mediów z URL; upewnij się, że adres jest prawidłowy i publiczny.
  • -2, podkod 2207003: pobieranie trwało zbyt długo; tę sytuację warto ponowić.
  • 36000, podkod 2207004: obraz ma ponad 8 MB.
  • 36001, podkod 2207005: format obrazu nie jest obsługiwany; użyj JPEG.
  • 36003, podkod 2207009: proporcje obrazu wykraczają poza zakres od 4:5 do 1.91:1.
  • 352, podkod 2207026: format wideo nie jest obsługiwany; użyj MOV lub MP4.

Co oznaczają błędy publikacji dotyczące czasu i limitów?

Błędy dotyczące tego, kiedy i ile, z których większość rozwiązuje się przez czekanie lub zaczynanie od nowa:

  • 9007, podkod 2207027: media nie są gotowe; czekaj, aż status_code kontenera będzie miał wartość FINISHED.
  • 24, podkod 2207008: kontener nie istnieje lub wygasł; ponów próbę raz lub dwa razy w ciągu 30 sekund do 2 minut, a potem utwórz nowy.
  • -2, podkod 2207020: media wygasły; utwórz nowy kontener.
  • 9, podkod 2207042: konto osiągnęło dzienny limit publikacji; spróbuj następnego dnia.
  • 100, podkod 2207028: karuzela wymaga od 2 do 10 elementów.
  • 36004, podkod 2207010: podpis jest za długi; limity Meta to 2,200 znaków i 20 oznaczeń @, a jej dokumentacja podaje 30 hashtagów, choć Instagram dopuszcza 5 w jednym poście.
  • 4, podkod 2207051: Instagram ograniczył działanie jako podejrzane o spam.

Co oznaczają błędy wiadomości?

Błędy z DM i prywatnych odpowiedzi:

  • 10, podkod 2534022: wiadomość została wysłana poza dozwolonym oknem; poczekaj, aż osoba napisze ponownie.
  • 100, podkod 2534014: nie znaleziono pasującego użytkownika Instagrama; użyj identyfikatora Instagram-scoped z webhooka, a nie identyfikatora użytkownika Instagrama.
  • 100, podkod 2534025: do tego komentarza nie można wysłać prywatnej odpowiedzi.
  • 100, podkod 2534037: rozmową steruje inna aplikacja, w tym własne Business AI Meta.
  • 551, podkod 1545041: ta osoba jest obecnie niedostępna.

Co oznaczają błędy statystyk?

Żądania statystyk kończą się niepowodzeniem na trzy udokumentowane sposoby:

  • 10, za mało widzów, by media pokazały statystyki: metryka relacji poniżej 5.
  • Wycofana metryka, na przykład impressions od 21 kwietnia 2025, zwraca błąd; zamiast niej poproś o views.
  • Nieznany błąd, gdy jedna z kilku żądanych metryk nie obsługuje żądanego podziału.

Które błędy warto ponowić?

Tylko te tymczasowe: kody 1 i 2, błędy serwera Instagrama 2207001 i 2207032, przekroczenie czasu pobierania 2207003, chwilowy błąd 2207008 oraz limity żądań po upływie czasu oczekiwania. Wszystkie pozostałe zwracają tę samą odpowiedź, dopóki coś się nie zmieni, czy to plik, URL, uprawnienie, stan konta czy okno osoby, a ponawianie ich tylko zużywa limit żądań.

Typowe błędy

  • Ponawianie błędu formatu lub rozmiaru. 2207004, 2207005, 2207009 i 2207026 kończą się tak samo, dopóki media się nie zmienią.
  • Traktowanie 9007 jako porażki. Wideo wciąż się przetwarza; publikuj, gdy kontener będzie miał wartość FINISHED.
  • Czytanie tylko kodu. Kody takie jak 10 i 100 obejmują wiele przypadków, a to podkod wskazuje, o który chodzi.
  • Usuwanie fbtrace_id z logów. Pomoc techniczna Meta o niego prosi, a szybko wygasa po wystąpieniu błędu.
Z EasyCoexistence zrobisz to

Claude, ChatGPT lub Twój własny kod wywołują wtedy oficjalne API Meta z tokenem, który jest na bieżąco aktualizowany. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym: pierwsze 3 dni.

Najczęściej zadawane pytania

Co oznacza błąd 190 w Instagramie?

Token dostępu wygasł, został unieważniony lub jest w inny sposób nieprawidłowy, na przykład po zmianie hasła. Nowy token to naprawia, a w przypadku połączonego konta oznacza to ponowne połączenie.

Dlaczego publikacja kończy się błędem 9004?

Meta nie mogła pobrać mediów z podanego URL, podkod 2207052. Sprawdź, czy link jest prawidłowy i publiczny, bez logowania, w chwili publikacji posta.

Co oznacza błąd 9007?

Wideo w kontenerze wciąż się przetwarza, podkod 2207027. Sprawdź status_code kontenera i opublikuj, gdy będzie miał wartość FINISHED.

Czym jest fbtrace_id w błędzie Instagram API?

Identyfikatorem nieudanego żądania, o który pomoc techniczna Meta prosi przy zgłaszaniu problemu. Szybko wygasa po wystąpieniu błędu, dlatego zapisz go od razu w logach.

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