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

Ошибка TikTok 40002: ошибка параметра в запросе

Ошибка TikTok 40002 является ошибкой параметра: поле в запросе отсутствует, имеет неверный формат, не поддерживается или несовместимо с другим полем. Сообщение в ответе указывает проблему, например отсутствующее обязательное поле. Исправьте это поле по справочнику эндпоинта, например business_id, post_info или max_count в Accounts API, и отправьте запрос снова.

easyCoexistence добавляет business_id в каждый вызов TikTok, который делает для Claude, ChatGPT или вашего кода, и проверяет публикацию перед отправкой: видео или от 1 до 35 изображений по ссылкам HTTPS, при этом PNG-фото отклоняются, так как TikTok принимает только JPEG или WebP.

40002

Код возврата TikTok для ошибки параметра, подробности в тексте сообщения ответа.

HTTP 200

Статус примера ответа TikTok с кодом 40002: сбой показывает поле code, а не статус.

2,200

Количество символов в UTF-16, которое может содержать подпись к видео через Accounts API, включая до 30 упоминаний.

1 to 30

Количество комментариев на страницу, которое /business/comment/list/ принимает в max_count; по умолчанию 20.

60 days

Самая дальняя дата, до которой может доходить start_date при чтении инсайтов аккаунта через /business/get/.

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

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

Как читать ответ?

Начните с сообщения: в нём указано поле. Пример самого TikTok, приведённый ниже, возвращается с HTTP 200 и сообщением «Missing required field(s): account_id.» Другой пример в приложении: «Time format should be %Y-%m-%dT%H:%M.» Сохраняйте также request_id, так как справочники TikTok просят его при сообщении о проблеме.

TikTok's example 40002 response
HTTPS/1.1 200 OK
{
    "code": 40002,
    "message": "Missing required field(s): account_id.",
    "request_id": "2022110918305001025108614416C7CC00"
}

Какие правила Accounts API стоит проверить?

Каждый справочник эндпоинта задаёт свои правила. Ниже правила для вызовов, с помощью которых подключение публикует, работает с комментариями и читает инсайты:

  • Каждый вызов: business_id, равный open_id, полученному вместе с токеном доступа аккаунта.
  • Публикация видео: video_url и post_info обязательны, post_info даже когда пусто; подпись содержит до 2 200 символов.
  • Публикация фото: до 35 URL изображений в photo_images, privacy_level, который разрешён аккаунтом, и заголовок до 90 символов.
  • Комментарии: video_id это item_id публикации из /business/video/list/, max_count от 1 до 30, а comment_ids принимает не более 30.
  • Ответы: текст до 1 200 символов или изображение вместо него.
  • Инсайты: даты в виде 2021-06-01, в UTC, с глубиной не более 60 дней.

Как исправить?

Найдите в справочнике эндпоинта поле, которое указано в сообщении, исправьте его и отправьте запрос снова. Ошибка описывает сам запрос, поэтому отправка без изменений вернёт тот же код. Для значений, которые зависят от аккаунта, например уровней приватности или возможности включить комментарии, прочитайте допустимые варианты из /business/video/settings/ до публикации.

Что с проблемами в медиафайле?

TikTok сообщает о них после вызова. Эндпоинты публикации возвращают share_id задачи публикации, пока TikTok загружает файл. Если файл нарушает правило, /business/publish/status/ показывает FAILED с причиной, например file_format_check_failed, frame_rate_check_failed или picture_size_check_failed. TikTok отмечает эти причины как не подлежащие повтору, поэтому нужно изменить сам файл.

Распространённые ошибки

  • Повторная отправка того же запроса. 40002 описывает параметры, поэтому ничего не изменится, пока не исправлено поле, указанное в сообщении.
  • Передача параметров-массивов как простого текста. Поля вроде fields отправляются как массивы JSON, как в примере TikTok ["display_name", "profile_image"].
  • Использование одной настройки приватности для всех аккаунтов. Варианты различаются для открытых и закрытых аккаунтов, поэтому сначала прочитайте privacy_level_options из /business/video/settings/.
  • Установка disable_comment в false для аккаунта, у которого комментарии отключены. Когда comment_disabled равно true, TikTok принимает только true.
Настройка с EasyCoexistence

Если TikTok всё равно отвечает 40002, инструмент возвращает его код и сообщение, чтобы ваш ИИ мог исправить поле и попробовать снова. От US$ 9 до US$ 0,75 за подключение в месяц, со снижением по мере добавления подключений, первые 3 дня бесплатно.

Часто задаваемые вопросы

Что такое ошибка параметра в API TikTok?

Это код возврата 40002: поле в запросе отсутствует, записано неверно, не поддерживается или несовместимо с другим полем, а сообщение указывает, какое именно.

Почему TikTok присылает ошибку 40002 с HTTP 200?

Коды возврата TikTok важнее HTTP-статуса, поэтому ответ 200, код которого не равен 0, всё равно означает неудачный вызов.

Нужно ли повторять запрос с ошибкой 40002?

Только после изменения запроса. Ошибку вызывают параметры, поэтому исправьте поле, указанное в сообщении, прежде чем отправлять запрос снова.

Где проявляются проблемы с видеофайлом?

В статусе публикации. Когда TikTok загрузил медиа, файл, нарушающий его правила, приводит к тому, что /business/publish/status/ показывает FAILED с причиной, которая называет проваленную проверку.

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

Ошибка TikTok 40007: объект не существуетОшибка TikTok 40007 означает, что запрос ссылается на объект, URL или файл, которого не существует. Какие ID Accounts API проверить и откуда каждый берётся.Ошибка TikTok 40001: нет разрешения на операциюОшибка TikTok 40001 означает, что у вызывающего приложения нет разрешения на операцию. Как проверить разрешение TikTok Accounts у приложения и scope токена.Ошибка TikTok 40100: слишком частые запросыОшибка TikTok 40100 означает, что запрос ограничен по частоте. Как найти её в ответе HTTP 200, сколько ждать и как не превышать лимит.Ошибка TikTok 40104: токен доступа пустОшибка TikTok 40104 означает, что запрос дошёл до API без токена доступа. Где Accounts API ожидает токен и как он пропадает.Ошибка TikTok 40110: недействительный код авторизацииОшибка TikTok 40110 означает, что auth_code отменён, уже использован или истёк. Коды Accounts API живут 10 минут и работают один раз. Как получить новый код.Ограничения подписи TikTok через API: длина, хэштеги и упоминанияДлина подписи видео и фото в TikTok через API для Business, работа хэштегов и упоминаний, переносы строк и лимиты фотопостов.

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

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

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

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