Zum Hauptinhalt springen

Profil-Skript-Konfiguration

Diese Seite dokumentiert die Konfigurationsparameter für das profile-Skript, das bei der Aufgabenerstellung verwendet wird.

Überblick​

Das profile-Skript wird verwendet, um automatisch ein TikTok-, Instagram- oder Threads-Profil zu aktualisieren. Es kann Avatar, Spitzname, Benutzername, Bio und Link-URL aktualisieren. Threads unterstützt Avatar-, Spitzname-, Bio- und Link-Updates. Der Benutzername gehört dem verknüpften Instagram-Konto, daher werden username_to / usernames auf Threads protokolliert und übersprungen, anstatt beiden Plattformen den gemeinsamen Benutzernamen unerwartet zu ändern.

Skript-Konfiguration (script_config)​

Das script_config-Objekt enthält die Parameter für das Profil-Skript. Nachfolgend die verfügbaren Parameter:

Parameter​

ParameterTypErforderlichStandardBeschreibung
usernamestringNein""Der Benutzername des Kontos, dessen Profil aktualisiert werden soll. Wird im gerätebasierten Modus verwendet.
avatars_pathstringNein""Pfad zu einem Ordner mit Avatar-Bildern. Leer lassen, um Avatar-Update zu überspringen.
nicknamestringNein""Ein einzelner Spitzname zum Festlegen. Hat Vorrang vor nicknames.
nicknamesstringNein""Mehrere durch Zeilenumbrüche getrennte Spitznamen. Einer wird basierend auf profile_order ausgewählt.
username_tostringNein""Neuer Benutzername zum Festlegen. Hat Vorrang vor usernames.
usernamesstringNein""Mehrere durch Zeilenumbrüche getrennte neue Benutzernamen. Einer wird basierend auf profile_order ausgewählt.
biostringNein""Ein einzelner Bio-Text zum Festlegen. Hat Vorrang vor bios.
biosstringNein""Mehrere durch Zeilenumbrüche getrennte Bio-Texte. Einer wird basierend auf profile_order ausgewählt.
link_urlstringNein""Ein einzelne Link-URL zum Festlegen. Hat Vorrang vor link_urls.
link_urlsstringNein""Mehrere durch Zeilenumbrüche getrennte Link-URLs. Einer wird basierend auf profile_order ausgewählt.
profile_orderstringNein"random"Wie Inhalte ausgewählt werden, wenn Multi-Wert-Felder verwendet werden: random oder sequential.
job_countintegerNein0Aufgabenezähler für die sequenzielle Auswahl. Wird automatisch vom System gesetzt.
hinweis

Mindestens eines der Profilfelder (Avatar, Spitzname, username_to, Bio, Link-URL) sollte angegeben werden. Andernfalls wird das Skript ausgeführt, nimmt aber keine Änderungen vor.

Beispiele​

Spitzname aktualisieren​

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"
    }
  }'

Avatar aktualisieren​

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/"
    }
  }'

Mehrere Konten mit verschiedenen Spitznamen aktualisieren​

Verwenden Sie nicknames mit profile_order: sequential, um verschiedene Spitznamen über Konten hinweg zuzuweisen:

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!"
    }
  }'

Profil im Benutzernamen-Modus aktualisieren​

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"
    }
  }'

Profil-Update planen​

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"
  }'

Antwort​

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

Profil-Reihenfolge​

Zufällige Reihenfolge (random)​

  • Wählt zufällig einen Wert aus Multi-Wert-Feldern (Spitznamen, Bios, etc.)
  • Standardverhalten

Sequenzielle Reihenfolge (sequential)​

  • Wählt Werte in Reihenfolge basierend auf job_count
  • Die erste Aufgabe verwendet den ersten Wert, die zweite Aufgabe den zweiten Wert usw.
  • Wiederholt von vorne, wenn das Ende erreicht ist
  • Gut, um verschiedene Werte verschiedenen Konten zuzuweisen

Fehlercodes​

CodeBeschreibung
40001Fehlende erforderliche Parameter
40003Skript wird über die API nicht unterstützt
40301API-Zugriff erfordert einen Pro+-Plan

Siehe auch​