API de Gestion des Tâches

Cette page documente tous les points de terminaison API disponibles pour gérer les tâches TikMatrix.

Créer une Tâche

Créez une nouvelle tâche pour un ou plusieurs appareils ou noms d'utilisateur.

• Point de terminaison : POST /api/v1/task
• Content-Type : application/json

Paramètres de Requête

L'API prend en charge deux modes pour créer des tâches :

Mode 1 : Mode Appareil - Utilisez serials pour créer des tâches pour les appareils Mode 2 : Mode Nom d'Utilisateur - Utilisez usernames pour créer directement des tâches pour des comptes spécifiques

Paramètre	Type	Requis	Description
serials	string[]	Conditionnel	Tableau des numéros de série des appareils (requis si usernames n'est pas fourni)
usernames	string[]	Conditionnel	Tableau des noms d'utilisateur (requis si serials n'est pas fourni). Lorsque ce paramètre est fourni, créez directement des tâches pour ces comptes.
script_name	string	Oui	Nom du script à exécuter
script_config	object	Oui	Paramètres de configuration du script (voir la documentation du script correspondant)
enable_multi_account	boolean	Non	Activer ou non le mode multi-compte (par défaut : false). Efficace uniquement en mode appareil.
start_time	string	Non	Heure d'exécution planifiée, au format "HH:MM"
close_app	boolean	Non	Indique si l'app cible est fermée (arrêt forcé) à la fin de la tâche (par défaut : true). Mettez false pour laisser l'app en cours d'exécution une fois la tâche terminée.
platform	string	Non	Plateforme cible (tiktok ou instagram). Utilisé uniquement par TikMatrix Pro ; ignoré par les versions à plateforme unique.

Scripts Pris en Charge

Nom du Script	Description	Documentation
post	Publier des vidéos ou des images sur TikTok/Instagram	Configuration du Script de Publication
follow	Suivre ou ne plus suivre des utilisateurs	Configuration du Script de Suivi
unfollow	Ne plus suivre des utilisateurs	Configuration du Script de Désabonnement
account_warmup	Préchauffer des comptes	Configuration du Script de Préchauffage de Compte
comment	Commenter des publications	Configuration du Script de Commentaire
login	Se connecter au compte	Configuration du Script de Connexion
profile	Mettre à jour le profil	Configuration du Script de Profil
match_account	Associer les comptes sur l'appareil	Configuration du Script de Correspondance de Compte
like	Aimer des publications	Configuration du Script Like
view	Regarder une publication pendant une durée	Configuration du Script View
favorite	Enregistrer une publication dans les Favoris	Configuration du Script Favorite
repost	Repartager des vidéos TikTok	Configuration du Script Repost
message	Envoyer un message privé	Configuration du Script Message
follow_suggested	Suivre les comptes suggérés	Configuration du Script Follow Suggested

Exemple

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Regardez ma nouvelle vidéo ! #tendance #recommandé",
      "material_list": ["C:/Videos/video1.mp4"],
      "upload_wait_time": 60
    }
  }'

Garder l'app ouverte après la tâche

Par défaut, l'app cible est arrêtée de force à la fin de la tâche, afin de refléter le comportement de l'application et de libérer les ressources de l'appareil. Passez "close_app": false pour laisser l'app en cours d'exécution une fois la tâche terminée — utile pour enchaîner des tâches ou inspecter le résultat sur l'appareil :

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "like",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@user/video/123"
    },
    "close_app": false
  }'

Pour les paramètres détaillés de script_config et plus d'exemples, veuillez consulter Configuration du Script de Publication.

Réponse

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [101, 102],
    "created_count": 2
  }
}

Lister les Tâches

Interrogez les tâches avec des conditions de filtrage optionnelles.

• Point de terminaison : GET /api/v1/task

Paramètre	Type	Requis	Description
status	integer	Non	Filtrer par état (0=pending, 1=running, 2=completed, 3=failed)
serial	string	Non	Filtrer par numéro de série de l'appareil
script_name	string	Non	Filtrer par nom de script
source	string	Non	Filtrer par source ("ui" ou "api")
page	integer	Non	Numéro de page (par défaut : 1)
page_size	integer	Non	Nombre d'entrées par page (par défaut : 20, maximum : 100)

Obtenir les Détails d'une Tâche

Obtenez les informations détaillées sur une tâche spécifique.

• Point de terminaison : GET /api/v1/task/{task_id}

Supprimer une Tâche

Supprimez une tâche. Si la tâche est en cours d'exécution, elle sera d'abord arrêtée.

• Point de terminaison : DELETE /api/v1/task/{task_id}

Supprimer Plusieurs Tâches

Supprimez plusieurs tâches à la fois, les tâches en cours d'exécution seront d'abord arrêtées.

• Point de terminaison : DELETE /api/v1/task/batch
• Corps de la requête : { "task_ids": [1, 2, 3] }

Arrêter une Tâche

Arrêtez une tâche en cours d'exécution.

• Point de terminaison : POST /api/v1/task/{task_id}/stop

Réessayer une Tâche Échouée

Réessayez une seule tâche échouée.

• Point de terminaison : POST /api/v1/task/{task_id}/retry

Réessayer Toutes les Tâches Échouées

Réessayez toutes les tâches échouées en une seule fois.

• Point de terminaison : POST /api/v1/task/retry-all

Obtenir les Statistiques des Tâches

Obtenez les statistiques globales des tâches.

• Point de terminaison : GET /api/v1/task/stats
• Réponse : Renvoie le nombre de total, pending, running, completed, failed.

Vérifier la Licence API

Vérifiez si votre licence prend en charge l'accès à l'API.

• Point de terminaison : GET /api/v1/license/check
• Note : Le forfait Starter renverra le code d'erreur 40301 ; les forfaits Pro/Team/Business peuvent accéder à l'API.