Configurazione Script Favorite

Questa pagina documenta i parametri di configurazione dello script favorite per la creazione di attività.

Panoramica

Lo script favorite aggiunge un post ai Preferiti (su TikTok) / Salvati (su Instagram). Quando fornisci più URL di post tramite API, viene creata un'attività per ogni URL. Puoi controllare quando viene eseguita ogni attività usando il parametro start_time.

I post già salvati nei Preferiti vengono ignorati

Lo script rileva i post già aggiunti ai Preferiti/Salvati e li ignora, quindi rieseguire un'attività non rimuoverà il post dai Preferiti.

Configurazione dello Script (script_config)

L'oggetto script_config contiene i parametri dello script favorite. Di seguito sono elencati i parametri disponibili:

Parametri

Parametro	Tipo	Richiesto	Predefinito	Descrizione
target_post_urls	string[]	Sì*	[]	Array di URL di post da aggiungere ai Preferiti (un'attività per URL)
target_post_url	string	Sì*	""	URL singolo o più URL separati da a capo/virgole

note

È necessario fornire l'array target_post_urls o il string target_post_url. Se vengono forniti entrambi, target_post_urls ha la priorità.

Creazione Attività

Quando vengono forniti più URL, l'API crea un'attività per ogni URL. Ad esempio, 3 URL + 2 dispositivi = 6 attività. Usa il parametro start_time per controllare quando viene eseguita ogni attività.

Esempi

Aggiungere un Post ai Preferiti

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

Aggiungere Più Post ai Preferiti

Quando si aggiungono più post ai Preferiti, viene creata un'attività per ogni post:

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

Vengono create 3 attività separate eseguite immediatamente.

Pianificare i Preferiti con Ora di Inizio

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

Aggiungere ai Preferiti tramite Lista Utenti

Crea attività di aggiunta ai Preferiti per account specifici:

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

Esempio Instagram

Su Instagram, lo script favorite salva il post (segnalibro):

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

Risposta

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [601, 602, 603],
    "created_count": 3
  }
}

Formati 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/

Threads

https://www.threads.com/@username/post/ABCDEFGHIJK
https://www.threads.com/t/ABCDEFGHIJK

I link threads.net funzionano anche. Un link /share/ non funziona: il suo codice è un identificatore diverso da quello usato da una pagina di post, quindi viene rifiutato anziché convertito in un URL che non punta a nulla.

Buone Pratiche

1. Pianifica le attività: Usa il parametro start_time per distribuire le azioni nel tempo, riducendo il rischio di limitazioni della frequenza.

2. Usa la modalità multi-account: Abilita enable_multi_account per aggiungere post ai Preferiti usando più account sullo stesso dispositivo.

Codici di Errore

Codice	Descrizione
40001	URL del post di destinazione mancante
40003	Script non supportato tramite API
40301	L'accesso all'API richiede il piano Pro+

Vedi Anche

• Configurazione Script Like - Mettere mi piace ai post
• Configurazione Script View - Guardare post per una durata
• API di Gestione Attività - Creare, elencare e gestire le attività
• Panoramica dell'API Locale - Panoramica API e avvio rapido