ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Ошибка TikTok 40100: слишком частые запросы

Ошибка TikTok 40100 означает, что запрос ограничен по частоте: TikTok возвращает код 40100 в теле ответа HTTP 200, поэтому один только статус этого не показывает. Исправление: приостановите вызовы этого эндпоинта на 5 минут после лимита в минуту или до 00:00 UTC после дневного лимита, затем отправляйте меньше, но более крупные запросы.

easyCoexistence передаёт код и сообщение TikTok в Claude, ChatGPT или ваш собственный код, чтобы ваш ИИ мог отличить ограничение частоты от неудачной публикации и подождать перед новой попыткой.

40100

Код, который TikTok возвращает, когда достигнут лимит частоты: запрос был ограничен.

HTTP 200

Статус, который TikTok передаёт вместе с кодами возврата, включая 40100; только код 0 в теле означает успех.

40 QPM

Лимит частоты Accounts API для каждого авторизованного аккаунта TikTok на каждом эндпоинте.

600 QPM

Все эндпоинты Accounts API вместе, для каждого приложения разработчика уровня Basic; более высокие уровни разрешают 1 000.

5 minutes

Как долго TikTok просит ждать перед следующим вызовом после достижения лимита в минуту.

15 a day

Максимальное число видеопубликаций, которое аккаунт может опубликовать через API за день, при не более чем шести в минуту.

Что означает ошибка 40100?

Ограничение частоты остановило запрос. Справочник кодов возврата TikTok описывает 40100 как слишком частые запросы: лимит эндпоинта на уровне приложения разработчика исчерпан, а руководство по ограничениям частоты говорит, что сервер возвращает 40100, когда лимит достигнут. Вызовы этого эндпоинта нужно приостановить до снятия ограничения.

Как обнаружить 40100 в коде?

По коду в теле ответа, а не по статусу HTTP. TikTok отправляет коды возврата с HTTP 200, поэтому проверяйте code в каждом ответе: 0 означает успех, 40100 означает запрос, ограниченный по частоте. Статус 4xx указывает на неверный путь или метод, а при 5xx TikTok советует подождать около 5 минут перед повтором:

Reading TikTok's answer in Node.js
// 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 часа, а не вызовы в минуту, поэтому замедление вызовов проблему не решит.
Настройка с EasyCoexistence

Его инструменты читают комментарии по 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 относится к уровню рекламодателя.

Читайте дальше

Лимиты TikTok API: запросы на аккаунт, приложение и эндпоинтЛимиты TikTok API: 40 запросов в минуту на аккаунт и эндпоинт, 600 или 1 000 в минуту на приложение в Accounts API и четыре уровня приложения.Лимиты публикаций TikTok API: сколько постов в деньСколько постов TikTok API публикует с одного аккаунта: шесть в минуту и 15 в день для эндпоинтов видео и фото, и что происходит сверх лимита.Ошибка TikTok 40002: ошибка параметра в запросеОшибка TikTok 40002: параметр запроса отсутствует, записан неверно или не разрешён. Как читать сообщение TikTok и какие правила Accounts API проверить.Ошибка TikTok 40001: нет разрешения на операциюОшибка TikTok 40001 означает, что у вызывающего приложения нет разрешения на операцию. Как проверить разрешение TikTok Accounts у приложения и scope токена.Ошибка TikTok 40007: объект не существуетОшибка TikTok 40007 означает, что запрос ссылается на объект, URL или файл, которого не существует. Какие ID Accounts API проверить и откуда каждый берётся.Ошибка TikTok 40105: токен доступа недействителен или неверенОшибка TikTok 40105: токен доступа недействителен или неверен. Что проверить в токене, как его обновить и когда владельцу нужно авторизоваться заново.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на