Configuration du Script Favorite

Cette page documente les paramètres de configuration du script favorite pour la création de tâches.

Description Générale

Le script favorite ajoute une publication aux Favoris (sur TikTok) / Enregistrés (sur Instagram). Lorsque vous fournissez plusieurs URLs de publications via l'API, une tâche est créée par URL. Vous pouvez contrôler le moment d'exécution de chaque tâche avec le paramètre start_time.

Les publications déjà enregistrées dans les Favoris sont ignorées

Le script détecte les publications déjà mises en favoris/enregistrées et les ignore, de sorte que réexécuter une tâche ne retirera pas la publication des favoris.

Configuration du Script (script_config)

L'objet script_config contient les paramètres du script favorite. Voici les paramètres disponibles :

Paramètres

Paramètre	Type	Requis	Défaut	Description
target_post_urls	string[]	Oui*	[]	Tableau d'URLs de publications à enregistrer en favoris (une tâche par URL)
target_post_url	string	Oui*	""	URL unique ou plusieurs URLs séparées par des sauts de ligne/virgules

remarque

Le tableau target_post_urls ou le string target_post_url doit être fourni. Si les deux sont fournis, target_post_urls est prioritaire.

Création de Tâches

Lorsque plusieurs URLs sont fournies, l'API crée une tâche par URL. Par exemple, 3 URLs + 2 appareils = 6 tâches. Utilisez le paramètre start_time pour contrôler quand chaque tâche s'exécute.

Exemples

Enregistrer une Publication dans les Favoris

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

Enregistrer Plusieurs Publications dans les Favoris

Lors de l'enregistrement de plusieurs publications, une tâche est créée par publication :

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

Cela crée 3 tâches indépendantes qui s'exécutent immédiatement.

Planifier des Favoris avec une Heure de Début

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

Enregistrer en Favoris par Liste d'Utilisateurs

Créer des tâches de favoris directement pour des comptes spécifiques :

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

Exemple Instagram (Enregistrer)

Sur Instagram, le script favorite enregistre la publication (signet) :

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

Réponse

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

Formats d'URL de Publications

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/

Meilleures Pratiques

1. Planifiez les tâches : Utilisez le paramètre start_time pour répartir les actions dans le temps, réduisant les risques de limitation de débit.

2. Utilisez le mode multi-compte : Activez enable_multi_account pour enregistrer des publications dans les favoris avec plusieurs comptes sur le même appareil.

Codes d'Erreur

Code	Description
40001	URL de publication cible manquante
40003	Script non pris en charge via API
40301	L'accès à l'API nécessite un forfait Pro+

Voir Aussi

• Configuration du Script Like - Aimer des publications
• Configuration du Script View - Visionner des publications pendant une durée
• API de Gestion des Tâches - Créer, lister et gérer les tâches
• Aperçu de l'API Locale - Description générale et démarrage rapide