Aller au contenu principal

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ètreTypeRequisDéfautDescription
target_post_urlsstring[]Oui*[]Tableau d'URLs de publications à enregistrer en favoris (une tâche par URL)
target_post_urlstringOui*""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/

Threads​

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

Les liens threads.net fonctionnent aussi. Un lien /share/ ne fonctionne pas : son code est un identifiant différent de celui qu'utilise une page de publication, il est donc refusé plutôt que converti en une URL qui ne mène nulle part.

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​

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

Voir Aussi​