Błąd TikTok 40100: zbyt częste żądania
Błąd TikTok 40100 oznacza, że limit częstotliwości ograniczył żądanie: TikTok zwraca kod 40100 w treści odpowiedzi HTTP 200, więc sam status nie pokazuje problemu. Rozwiązaniem jest wstrzymanie wywołań tego endpointu: na 5 minut po limicie na minutę albo do 00:00 UTC po limicie dziennym, a potem wysyłanie mniejszej liczby większych żądań.
easyCoexistence przekazuje kod i komunikat TikTok do Claude, ChatGPT lub do twojego własnego kodu, dzięki czemu AI odróżni limit częstotliwości od nieudanej publikacji i poczeka przed kolejną próbą.
Kod, który TikTok zwraca po osiągnięciu limitu częstotliwości, czyli żądanie zostało ograniczone.
Status, który TikTok wysyła wraz z kodami zwrotnymi, w tym 40100; tylko kod 0 w treści oznacza sukces.
Limit częstotliwości zapytań Accounts API dla każdego autoryzowanego konta TikTok i każdego endpointu.
Łączny limit wszystkich endpointów Accounts API na aplikację deweloperską na poziomie Basic; wyższe poziomy pozwalają na 1 000.
Czas, jaki TikTok podaje jako odstęp przed ponowieniem wywołania po przekroczeniu limitu na minutę.
Najwięcej publikacji wideo, jakie konto może opublikować przez API w ciągu doby, przy maksymalnie sześciu na minutę.
Co oznacza błąd 40100?
Limit częstotliwości wstrzymał żądanie. W dokumentacji TikTok kod zwrotny 40100 opisano jako zbyt częste żądania, ponieważ osiągnięto limit endpointu na poziomie aplikacji deweloperskiej. Według przewodnika o limitach serwer zwraca 40100, gdy limit zostanie osiągnięty. Wywołania tego endpointu muszą być wstrzymane do czasu zniesienia blokady.
Jak wykryć 40100 w kodzie?
Po kodzie w treści odpowiedzi, a nie po statusie HTTP. TikTok wysyła kody zwrotne z HTTP 200, więc sprawdzaj pole code w każdej odpowiedzi: 0 oznacza sukces, a 40100 żądanie ograniczone. Status 4xx wskazuje na błędną ścieżkę lub metodę, a przy 5xx TikTok zaleca odczekanie około 5 minut przed ponowieniem:
// TikTok returns its error codes with HTTP 200: read code, not only the status.
async function callTikTok(url, accessToken) {
const res = await fetch(url, { headers: { "Access-Token": accessToken } });
if (res.status >= 500) return { retryInMs: 5 * 60_000 }; // TikTok: wait about 5 minutes
if (!res.ok) throw new Error("HTTP " + res.status + ": check the path and the method");
const body = await res.json();
if (body.code === 40100) return { retryInMs: 5 * 60_000 }; // throttled: pause this endpoint
if (body.code !== 0) throw new Error("TikTok " + body.code + ": " + body.message);
return { data: body.data };
}Które limity mogą zwrócić 40100?
Przewodnik o limitach TikTok mówi, że serwer zwraca 40100, gdy osiągnięto limit, a każdy limit liczy się osobno. Pełne wartości według poziomu aplikacji znajdziesz na stronie limitów. Wywołanie Accounts API liczy się wobec trzech limitów:
- 40 zapytań na minutę dla każdego autoryzowanego konta i każdego endpointu Accounts API, takie samo na każdym poziomie aplikacji.
- 600 zapytań na minutę w Accounts API na aplikację deweloperską na poziomie Basic, a 1 000 na poziomach wyższych.
- Limity endpointów dla aplikacji według sekundy, minuty i dnia, ustalane przez poziom aplikacji.
Jak długo czekać?
Zależy od tego, który limit został osiągnięty. Po limicie na minutę TikTok zaleca odczekać 5 minut przed kolejnym wywołaniem. Po limicie dziennym czekaj do następnego dnia, ponieważ limity dzienne resetują się o 00:00:00 UTC. Przewodnik TikTok dodaje, że limity specyficzne dla endpointu są niezależne, więc osiągnięcie limitu jednego endpointu nie blokuje wywołań innego.
Czy limit 15 postów dziennie to ten sam limit?
Nie. Limit publikacji liczy posty: sześć na minutę i 15 dziennie na konto dla każdego endpointu publikacji. Post ponad ten limit kończy się niepowodzeniem w swoim statusie publikacji z kodem spam_risk_too_many_posts, a nie 40100. TikTok radzi w takim przypadku opublikować post z aplikacji mobilnej TikTok, a szczegóły opisuje strona limitów publikacji.
Jak zmieścić się w limitach?
TikTok zaleca wysyłać mniej, ale większych żądań i ograniczać liczbę równoległych. W Accounts API oznacza to odczytywanie do 20 postów na stronę /business/video/list/ i do 30 komentarzy na stronę /business/comment/list/ zamiast pobierania ich pojedynczo, rozłożenie wywołań za pomocą token bucket albo ustawienie ich w kolejce, tak aby stała liczba workerów je wysyłała, a nieudane zadania wracały do kolejki po opóźnieniu.
Czy wyższy poziom aplikacji zatrzyma 40100?
Tylko wtedy, gdy osiągnięto limit aplikacji. Każda aplikacja zaczyna na poziomie Basic, a TikTok podnosi go o jeden poziom naraz: z Basic na Advanced, potem na Premium i Ultimate, po żądaniu złożonym w My Apps, App Detail, Authorization, które wymaga podania powodu. Przewodnik TikTok o Accounts API podaje limit 40 na minutę na konto i endpoint jako jedną wartość, niezależną od poziomu aplikacji, więc przy jednym aktywnym koncie wystarczy rozłożyć jego wywołania w czasie.
Typowe błędy
- Ponawianie natychmiast. Endpoint pozostaje ograniczony do zniesienia blokady, więc szybkie ponowienia zużywają wywołania bez przechodzenia.
- Pobieranie postów lub komentarzy pojedynczo. Wywołanie listy zwraca stronę do 20 postów lub 30 komentarzy, a każde wywołanie liczy się do 40 na minutę.
- Odpytywanie statusu publikacji w ciasnej pętli. Każde sprawdzenie to wywołanie /business/publish/status/, a identyfikatory postów mogą pojawić się po nawet trzech minutach, więc rozłóż sprawdzenia w czasie.
- Traktowanie spam_risk_too_many_posts jako limitu częstotliwości. Liczy on posty utworzone przez API w ciągu ostatnich 24 godzin, a nie wywołania na minutę, więc spowalnianie wywołań go nie usunie.
Jego narzędzia odczytują komentarze po 30 na stronę, a posty po 20 naraz, a publish_tiktok_post informuje AI z góry, że TikTok ogranicza publikacje przez API do około 15 postów dziennie na konto. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, im więcej połączeń, tym taniej, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Czy TikTok zwraca HTTP 429, gdy wywołanie jest ograniczone limitem?
TikTok w swoich przewodnikach opisuje ograniczone wywołanie jako kod 40100 w treści odpowiedzi HTTP 200 i nie podaje statusu 429, więc sprawdzaj pole code w każdej odpowiedzi.
Jak długo trwa ograniczenie TikTok 40100?
TikTok zaleca odczekać 5 minut po osiągnięciu limitu na minutę. Limit dzienny wygasa o 00:00:00 UTC, kiedy się resetuje.
Czy easyCoexistence sam ponawia wywołanie, które zwraca 40100?
Nie. Ograniczone wywołanie narzędzia wraca do twojego AI z kodem 40100 i komunikatem TikTok, a ograniczony post w kolejce kończy się niepowodzeniem z tym komunikatem i czeka w sekcji Needs attention, aż wybierzesz Retry.
Czy 40100 różni się od 40016?
W zestawieniu kodów TikTok oba kody mają ten sam opis, zbyt częste żądania na poziomie aplikacji deweloperskiej, i to samo rozwiązanie: sprawdź przewodnik o limitach. Kod 40133 dotyczy poziomu reklamodawcy.
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