Конфигурация скрипта избранного

На этой странице описаны параметры скрипта favorite для создания задач.

Обзор

Скрипт favorite добавляет публикацию в Избранное (на TikTok) / Сохранённое (в Instagram). При нескольких URL через API для каждого URL создаётся задача. Управляйте временем выполнения через start_time.

Уже добавленные публикации пропускаются

Скрипт определяет публикации, которые уже в избранном, и пропускает их — повторный запуск задачи не снимет публикацию с избранного.

Конфигурация скрипта (script_config)

Параметры конфигурации скрипта избранного:

Параметры

Параметр	Тип	Обязательный	По умолчанию	Описание
target_post_urls	string[]	Yes*	[]	Массив целевых URL для добавления в избранное (одна задача на URL)
target_post_url	string	Yes*	""	Один URL или несколько URL, разделённых переносами/запятыми

примечание

Нужен массив target_post_urls или строка target_post_url. Если оба, приоритет у target_post_urls.

Создание задач

При нескольких URL API создаёт одну задачу на URL. Например, 3 URL + 2 устройства = 6 задач. Используйте start_time для управления временем выполнения.

Примеры

Добавить одну публикацию в избранное

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    }
  }'

Добавить несколько публикаций в избранное

Для каждой публикации создаётся задача:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222",
        "https://www.tiktok.com/@user3/video/333"
      ]
    }
  }'

Создаёт 3 задачи, выполняемые немедленно.

Планирование с временем начала

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    },
    "start_time": "14:30"
  }'

Добавление в избранное через список пользователей

Создание задач для конкретных аккаунтов:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123"
    }
  }'

Пример Instagram

В Instagram скрипт favorite сохраняет публикацию (закладки):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/"
    }
  }'

Ответ

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [601, 602, 603],
    "created_count": 3
  }
}

Форматы URL публикаций

TikTok

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

Лучшие практики

1. Планируйте задачи: Используйте start_time для распределения действий во времени.

2. Мультиаккаунт: Включите enable_multi_account для добавления в избранное с нескольких аккаунтов на одном устройстве.

Коды ошибок

Code	Description
40001	Отсутствует целевой URL
40003	Скрипт не поддерживается через API
40301	Требуется план Pro+

См. также

• Конфигурация скрипта лайков - Поставить лайки
• Конфигурация скрипта просмотра - Просмотр публикаций
• API управления задачами - Создание, просмотр и управление задачами
• Обзор локального API - Обзор API и быстрый старт