Configurazione Script Profilo

Questa pagina documenta i parametri di configurazione per lo script profile utilizzato nella creazione delle attività.

Panoramica

Lo script profile viene utilizzato per aggiornare automaticamente il profilo di un account TikTok, Instagram o Threads. Threads supporta gli aggiornamenti di avatar, nome, bio e link. Il suo nome utente è di proprietà dell'account Instagram collegato, quindi le voci username_to / usernames vengono registrate e saltate su Threads invece di cambiare inaspettatamente il nome utente condiviso.

Configurazione dello Script (script_config)

L'oggetto script_config contiene i parametri per lo script di profilo. Di seguito sono riportati i parametri disponibili:

Parametri

Parametro	Tipo	Obbligatorio	Predefinito	Descrizione
username	string	No	""	Il nome utente dell'account il cui profilo aggiornare. Usato in modalità basata su dispositivo.
avatars_path	string	No	""	Percorso di una cartella contenente immagini avatar. Lasciare vuoto per saltare l'aggiornamento dell'avatar.
nickname	string	No	""	Singolo soprannome da impostare. Ha priorità su nicknames.
nicknames	string	No	""	Più soprannomi separati da interruzioni di riga. Uno viene selezionato in base a profile_order.
username_to	string	No	""	Nuovo nome utente da impostare. Ha priorità su usernames.
usernames	string	No	""	Più nomi utente separati da interruzioni di riga. Uno viene selezionato in base a profile_order.
bio	string	No	""	Testo bio singolo da impostare. Ha priorità su bios.
bios	string	No	""	Più testi bio separati da interruzioni di riga. Uno viene selezionato in base a profile_order.
link_url	string	No	""	Singolo URL di link da impostare. Ha priorità su link_urls.
link_urls	string	No	""	Più URL di link separati da interruzioni di riga. Uno viene selezionato in base a profile_order.
profile_order	string	No	"random"	Come selezionare il contenuto quando si utilizzano campi multivalore: random o sequential.
job_count	integer	No	0	Contatore di lavoro utilizzato per la selezione sequenziale. Impostato automaticamente dal sistema.

note

Almeno uno dei campi profilo (avatar, nickname, username_to, bio, link_url) deve essere fornito. Altrimenti lo script viene eseguito ma non apporta modifiche.

Esempi

Aggiorna Soprannome

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": "Il mio nuovo soprannome"
    }
  }'

Aggiorna Bio e Link

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": "Guarda i miei ultimi contenuti!",
      "link_url": "https://example.com"
    }
  }'

Aggiorna Avatar

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

Aggiorna Più Account con Soprannomi Diversi

Usa nicknames con profile_order: sequential per assegnare soprannomi diversi tra account:

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": "Soprannome Uno\nSoprannome Due\nSoprannome Tre",
      "profile_order": "sequential",
      "bio": "Seguimi per contenuti sorprendenti!"
    }
  }'

Aggiorna Profilo in Modalità Nome Utente

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@account1", "@account2"],
    "script_name": "profile",
    "script_config": {
      "nickname": "Nuovo Nome Brand",
      "bio": "Bio aggiornata per tutti gli account",
      "link_url": "https://mybrand.com"
    }
  }'

Pianifica Aggiornamento Profilo

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": "Soprannome Aggiornato",
      "bio": "Contenuti freschi ogni giorno!"
    },
    "start_time": "10:00"
  }'

Risposta

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

Ordine Profilo

Ordine Casuale (random)

• Seleziona casualmente un valore dai campi multivalore (soprannomi, bio, ecc.)
• Comportamento predefinito

Ordine Sequenziale (sequential)

• Seleziona i valori in ordine in base a job_count
• Il primo compito usa il primo valore, il secondo compito usa il secondo valore, ecc.
• Torna all'inizio quando raggiunge la fine
• Buono per assegnare valori diversi a account diversi

Codici di Errore

Codice	Descrizione
40001	Parametri obbligatori mancanti
40003	Script non supportato tramite API
40301	L'accesso all'API richiede un piano Pro+

Vedi Anche

• API di Gestione Attività - Crea, elenca e gestisci attività
• Configurazione Script Login - Accedi all'account
• Configurazione Script Corrispondenza Account - Abbina account sul dispositivo
• Panoramica dell'API Locale - Panoramica API e avvio rapido