Перейти к основному содержимому

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

На этой странице описаны параметры конфигурации скрипта follow, используемого при создании задач.

Обзор​

Скрипт follow используется для автоматической подписки на пользователей в TikTok или Instagram. При указании нескольких целевых пользователей через API система создаёт по одной задаче для каждого пользователя. Вы можете контролировать время выполнения задач с помощью параметра start_time.

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

Объект script_config содержит параметры скрипта подписки. Ниже приведены доступные параметры:

Параметры​

ПараметрТипОбязательныйПо умолчаниюОписание
target_usersstring[]Да*[]Массив целевых имён пользователей (одна задача на пользователя)
target_userstringДа*""Одно имя пользователя или несколько имён, разделённых переносами строк/запятыми
access_methodstringНет"direct"Способ перехода к профилю: direct (по URL) или search
примечание

Необходимо указать либо массив target_users, либо строку target_user. Если указаны оба, приоритет имеет target_users.

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

При указании нескольких целевых пользователей API создаёт по одной задаче для каждого. Например, при указании 3 целевых пользователей и 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": "follow",
    "script_config": {
      "target_users": ["@username_to_follow"],
      "access_method": "direct"
    }
  }'

Подписка на нескольких пользователей​

При подписке на нескольких пользователей для каждого создаётся отдельная задача:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@user1", "@user2", "@user3"],
      "access_method": "direct"
    }
  }'

Это создаст 3 отдельные задачи, которые выполнятся немедленно.

Планирование задач по времени​

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

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@user1", "@user2"],
      "access_method": "direct"
    },
    "start_time": "14:30"
  }'

Подписка через поиск​

Используйте метод поиска, когда прямой доступ по URL не работает:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["username1", "username2"],
      "access_method": "search"
    }
  }'

Пакетная подписка на нескольких устройствах​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "follow",
    "script_config": {
      "target_users": ["@influencer_account"],
      "access_method": "direct"
    },
    "enable_multi_account": true
  }'

Ответ​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [201, 202, 203],
    "created_count": 3
  }
}

Методы доступа​

Прямой метод (direct)​

  • Открывает профиль по URL: tiktok.com/@username или instagram.com/username
  • Быстрее и надёжнее
  • Рекомендуется для большинства случаев
  • Переходит в поиск, вводит имя пользователя, нажимает на результат
  • Медленнее, но работает при блокировке прямого доступа
  • Может быть менее точным при наличии похожих имён

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

  1. Используйте start_time для планирования: Используйте параметр start_time для планирования времени выполнения задач (формат: "HH:MM").

  2. Предпочитайте прямой доступ: Метод direct быстрее и надёжнее, чем search.

  3. Разумная пакетная обработка: Не подписывайтесь на слишком много пользователей за раз. Система создаёт по одной задаче на каждого пользователя, поэтому большие списки создают много задач.

См. также​