Ошибка TikTok 40100: слишком частые запросы
Ошибка TikTok 40100 означает, что запрос ограничен по частоте: TikTok возвращает код 40100 в теле ответа HTTP 200, поэтому один только статус этого не показывает. Исправление: приостановите вызовы этого эндпоинта на 5 минут после лимита в минуту или до 00:00 UTC после дневного лимита, затем отправляйте меньше, но более крупные запросы.
easyCoexistence передаёт код и сообщение TikTok в Claude, ChatGPT или ваш собственный код, чтобы ваш ИИ мог отличить ограничение частоты от неудачной публикации и подождать перед новой попыткой.
Код, который TikTok возвращает, когда достигнут лимит частоты: запрос был ограничен.
Статус, который TikTok передаёт вместе с кодами возврата, включая 40100; только код 0 в теле означает успех.
Лимит частоты Accounts API для каждого авторизованного аккаунта TikTok на каждом эндпоинте.
Все эндпоинты Accounts API вместе, для каждого приложения разработчика уровня Basic; более высокие уровни разрешают 1 000.
Как долго TikTok просит ждать перед следующим вызовом после достижения лимита в минуту.
Максимальное число видеопубликаций, которое аккаунт может опубликовать через API за день, при не более чем шести в минуту.
Что означает ошибка 40100?
Ограничение частоты остановило запрос. Справочник кодов возврата TikTok описывает 40100 как слишком частые запросы: лимит эндпоинта на уровне приложения разработчика исчерпан, а руководство по ограничениям частоты говорит, что сервер возвращает 40100, когда лимит достигнут. Вызовы этого эндпоинта нужно приостановить до снятия ограничения.
Как обнаружить 40100 в коде?
По коду в теле ответа, а не по статусу HTTP. TikTok отправляет коды возврата с HTTP 200, поэтому проверяйте code в каждом ответе: 0 означает успех, 40100 означает запрос, ограниченный по частоте. Статус 4xx указывает на неверный путь или метод, а при 5xx TikTok советует подождать около 5 минут перед повтором:
// 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 };
}Какие лимиты могут вернуть 40100?
В руководстве по ограничениям частоты сказано, что сервер возвращает 40100, когда лимит достигнут, и что каждый лимит считается отдельно. Полные значения по уровням приложения приведены на странице ограничений частоты. Вызов Accounts API учитывается по трём лимитам:
- 40 запросов в минуту для каждого авторизованного аккаунта на каждом эндпоинте Accounts API, одинаково на всех уровнях приложения.
- 600 запросов в минуту в Accounts API на приложение разработчика уровня Basic и 1 000 выше него.
- Лимиты эндпоинта для приложения по секундам, минутам и дням, которые задаёт уровень приложения.
Как долго ждать?
Это зависит от того, какой лимит достигнут. После лимита в минуту TikTok советует подождать 5 минут до следующего вызова. После дневного лимита ждите до следующего дня, так как дневные лимиты сбрасываются в 00:00:00 UTC. Руководство TikTok добавляет, что лимиты отдельных эндпоинтов независимы, поэтому достижение лимита одного эндпоинта не останавливает вызовы другого.
Это тот же лимит, что и 15 публикаций в день?
Нет. Ограничение публикаций считает посты: не более шести в минуту и 15 в день на аккаунт на каждом эндпоинте публикации. Пост сверх этого лимита завершается неудачей в статусе публикации с кодом spam_risk_too_many_posts, а не 40100. TikTok советует в таком случае опубликовать пост из мобильного приложения TikTok, об этом написано на странице ограничений публикаций.
Как уложиться в лимиты?
Совет TikTok: делать меньше, но более крупных запросов и ограничивать число одновременных. В Accounts API это значит читать до 20 постов на страницу /business/video/list/ и до 30 комментариев на страницу /business/comment/list/ вместо получения их по одному. Также можно распределять вызовы во времени по алгоритму токен-бакета или ставить их в очередь, чтобы фиксированное число рабочих процессов отправляло их, а неудачные задачи возвращались в очередь с задержкой.
Поможет ли более высокий уровень приложения избавиться от 40100?
Только если достигнут лимит приложения. Каждое приложение начинает с уровня Basic, и TikTok повышает его по одному шагу: от Basic к Advanced, затем к Premium и Ultimate, по запросу, оформленному через My Apps, App Detail, Authorization, с указанием причины. В руководстве TikTok по Accounts API лимит 40 в минуту на аккаунт и эндпоинт указан одним значением, отдельно от уровня приложения, поэтому один загруженный аккаунт решается растягиванием его вызовов во времени.
Распространённые ошибки
- Повторять сразу. Эндпоинт остаётся ограниченным до снятия приостановки, поэтому быстрые повторы тратят вызовы впустую.
- Получать посты или комментарии по одному. Вызов списка возвращает страницу до 20 постов или 30 комментариев, и каждый вызов учитывается в лимите 40 в минуту.
- Опрос статуса публикации в плотном цикле. Каждая проверка является вызовом /business/publish/status/, а ID постов могут появляться до трёх минут, поэтому делайте проверки с интервалами.
- Принимать spam_risk_too_many_posts за ограничение частоты. Он считает посты, созданные через API за последние 24 часа, а не вызовы в минуту, поэтому замедление вызовов проблему не решит.
Его инструменты читают комментарии по 30 на страницу и посты по 20 за раз, а publish_tiktok_post заранее сообщает ИИ, что TikTok ограничивает публикацию через API примерно 15 постами в день на аккаунт. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, с бесплатным пробным периодом в 3 дня.
Часто задаваемые вопросы
Возвращает ли TikTok HTTP 429, когда вызов ограничен по частоте?
В руководствах TikTok ограниченный вызов описан как код 40100 в теле ответа HTTP 200, статус 429 не упоминается, поэтому проверяйте поле code в каждом ответе.
Как долго длится ограничение TikTok 40100?
TikTok советует подождать 5 минут после достижения лимита в минуту. Дневной лимит снимается в 00:00:00 UTC, когда он сбрасывается.
Повторяет ли easyCoexistence вызов, который возвращает 40100?
Сам по себе нет. Ограниченный вызов инструмента возвращается вашему ИИ с кодом 40100 и сообщением TikTok, а ограниченная публикация в очереди завершается с этим сообщением и ждёт в разделе «Требует внимания», пока вы не выберете «Повторить».
Отличается ли 40100 от 40016?
В справочнике TikTok оба кода описаны одинаково: слишком частые запросы на уровне приложения разработчика, и решение одно: см. руководство по ограничениям частоты. 40133 относится к уровню рекламодателя.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на