Ошибка 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.
Код возврата TikTok для ошибки параметра, подробности в тексте сообщения ответа.
Статус примера ответа TikTok с кодом 40002: сбой показывает поле code, а не статус.
Количество символов в UTF-16, которое может содержать подпись к видео через Accounts API, включая до 30 упоминаний.
Количество комментариев на страницу, которое /business/comment/list/ принимает в max_count; по умолчанию 20.
Самая дальняя дата, до которой может доходить 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 просят его при сообщении о проблеме.
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.
Если 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 с причиной, которая называет проваленную проверку.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на