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

На цій сторінці описано параметри скрипту 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	Скрипт не підтримується
40301	Потрібен план Pro+

Дивіться також

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