Перейти до основного вмісту

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

На цій сторінці описано параметри конфігурації для скрипту profile, який використовується при створенні завдань.

Огляд​

Скрипт profile автоматично оновлює профіль TikTok, Instagram або Threads. Threads підтримує оновлення аватара, імені, біографії та посилання. Його ім'я користувача належить пов'язаному акаунту Instagram, тому username_to / usernames логуються й пропускаються на Threads замість неочікуваної зміни обох платформ.

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

Об'єкт script_config містить параметри для скрипту профіля. Нижче наведено доступні параметри:

Параметри​

ParameterTypeRequiredDefaultDescription
usernamestringNo""The username of the account whose profile to update. Used in device-based mode.
avatars_pathstringNo""Path to a folder containing avatar images. Leave empty to skip avatar update.
nicknamestringNo""Single nickname to set. Takes priority over nicknames.
nicknamesstringNo""Multiple nicknames separated by newlines. One is selected based on profile_order.
username_tostringNo""New username to set. Takes priority over usernames.
usernamesstringNo""Multiple new usernames separated by newlines. One is selected based on profile_order.
biostringNo""Single bio text to set. Takes priority over bios.
biosstringNo""Multiple bio texts separated by newlines. One is selected based on profile_order.
link_urlstringNo""Single link URL to set. Takes priority over link_urls.
link_urlsstringNo""Multiple link URLs separated by newlines. One is selected based on profile_order.
profile_orderstringNo"random"How to select content when using multi-value fields: random or sequential.
job_countintegerNo0Job counter used for sequential selection. Automatically set by the system.
примітка

Має бути надано щонайменше одне з полів профіля (аватар, нікнейм, username_to, біографія, посилання). Інакше скрипт запуститься, але змін не внесе.

Приклади​

Оновлення нікнейму​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "nickname": "My New Nickname"
    }
  }'

Оновлення біографії та посилання​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "bio": "Check out my latest content!",
      "link_url": "https://example.com"
    }
  }'

Оновлення аватара​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "avatars_path": "C:/avatars/"
    }
  }'

Оновлення кількох акаунтів з різними нікнеймами​

Використовуйте nicknames з profile_order: sequential, щоб призначити різні нікнейми різним акаунтам:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2", "device_serial_3"],
    "script_name": "profile",
    "script_config": {
      "nicknames": "Nickname One\nNickname Two\nNickname Three",
      "profile_order": "sequential",
      "bio": "Follow me for amazing content!"
    }
  }'

Оновлення профілю за режимом імені користувача​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@account1", "@account2"],
    "script_name": "profile",
    "script_config": {
      "nickname": "New Brand Name",
      "bio": "Updated bio for all accounts",
      "link_url": "https://mybrand.com"
    }
  }'

Планування оновлення профілю​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "profile",
    "script_config": {
      "username": "@my_account",
      "nickname": "Updated Nickname",
      "bio": "Fresh content every day!"
    },
    "start_time": "10:00"
  }'

Відповідь​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [401, 402],
    "created_count": 2
  }
}

Порядок вибору профілю​

Випадковий порядок (random)​

  • Випадково обирає одне значення з багатозначних полів (нікнейми, біографії тощо)
  • Поведінка за замовчуванням

Послідовний порядок (sequential)​

  • Обирає значення по порядку на основі job_count
  • Перше завдання використовує перше значення, друге завдання — друге значення тощо
  • Повертається на початок після досягнення кінця
  • Добре підходить для призначення різних значень різним акаунтам

Коди помилок​

КодОпис
40001Відсутні обов'язкові параметри
40003Скрипт не підтримується через API
40301Доступ до API потребує плану Pro+

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