Gestione Attività API

本页面记录了Gestione TikMatrix Attività的TuttiDisponibile API 端点。

创建Attività

为一个或多个Dispositivi或用户名创建新Attività。

• 端点： POST /api/v1/task
• Content-Type： application/json

请求参数

API Supporto两种模式创建Attività：

模式 1：Dispositivi模式 - Utilizzo serials 为Dispositivi创建Attività 模式 2：用户名模式 - Utilizzo usernames 直接为特定Account创建Attività

参数	类型	必需	Descrizione
serials	string[]	条件必需	Dispositivi序列号数组（如果未提供 usernames 则必需）
usernames	string[]	条件必需	用户名数组（如果未提供 serials 则必需）。提供此参数时，直接为这些Account创建Attività。
script_name	string	Sì	要Esegui的Script名称
script_config	object	Sì	Script的Configurazione参数（请参阅对应ScriptDocumentazione）
enable_multi_account	boolean	No	VuoiAbilita多Account模式（Predefinito：false）。仅在Dispositivi模式下生效。
start_time	string	No	计划Esegui时间，格式为 "HH:MM"
close_app	boolean	No	Se l'app di destinazione viene chiusa (arresto forzato) al termine dell'attività (predefinito: true). Imposta false per lasciare l'app in esecuzione al completamento.
platform	string	No	Piattaforma di destinazione (tiktok o instagram). Usato solo da TikMatrix Pro; ignorato dalle versioni a piattaforma singola.

Supporto的Script

Script名称	Descrizione	Documentazione
post	Pubblica video o immagini su TikTok/Instagram	Configurazione Script Post
follow	Segui o smetti di seguire gli utenti	Configurazione Script Follow
unfollow	Smetti di seguire gli utenti	Configurazione Script Unfollow
account_warmup	Riscalda gli account	Configurazione Script Account Warmup
comment	Commenta i post	Configurazione Script Comment
login	Accedi all'account	Configurazione Script Login
profile	Aggiorna profilo	Configurazione Script Profilo
match_account	Abbina account sul dispositivo	Configurazione Script Corrispondenza Account
like	Metti mi piace ai post	Configurazione Script Like
view	Visualizza un post per una durata	Configurazione Script View
favorite	Salva un post nei Preferiti	Configurazione Script Favorite
repost	Ricondividi video TikTok	Configurazione Script Repost
message	Invia messaggi diretti	Configurazione Script Message
follow_suggested	Segui account suggeriti	Configurazione Script Follow Suggested

Esempio

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": "看看我的新视频！#热门 #推荐",
      "material_list": ["C:/Videos/video1.mp4"],
      "upload_wait_time": 60
    }
  }'

Mantenere l'app aperta dopo l'attività

Per impostazione predefinita, l'app di destinazione viene arrestata forzatamente al termine dell'attività, per rispecchiare il comportamento dell'app e liberare le risorse del dispositivo. Passa "close_app": false per lasciare l'app in esecuzione al completamento — utile per concatenare attività o ispezionare il risultato sul dispositivo:

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

有关 script_config 的详细参数和AltroEsempio，请参阅 Post 脚本配置。

响应

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

列表Attività

UtilizzoOpzionale过滤条件查询Attività。

• 端点： GET /api/v1/task

参数	类型	必需	Descrizione
status	integer	No	按状态过滤（0=pending, 1=running, 2=completed, 3=failed）
serial	string	No	按Dispositivi序列号过滤
script_name	string	No	按Script名称过滤
source	string	No	按来源过滤（"ui" 或 "api"）
page	integer	No	页码（Predefinito：1）
page_size	integer	No	Ogni页条目数（Predefinito：20，最大：100）

获取AttivitàDettagli

获取指定Attività的Dettagli。

• 端点： GET /api/v1/task/{task_id}

EliminaAttività

EliminaAttività。如果Attività正在Esegui，会先尝试Ferma它。

• 端点： DELETE /api/v1/task/{task_id}

In MassaEliminaAttività

一volteElimina多个Attività，正在Esegui的Attività会先被Ferma。

• 端点： DELETE /api/v1/task/batch
• 请求体： { "task_ids": [1, 2, 3] }

Ferma Attività

Ferma正在Esegui的Attività。

• 端点： POST /api/v1/task/{task_id}/stop

RiprovaFallitoAttività

Riprova单个FallitoAttività。

• 端点： POST /api/v1/task/{task_id}/retry

RiprovaTuttiFallitoAttività

一volte性RiprovaTuttiFallito的Attività。

• 端点： POST /api/v1/task/retry-all

获取Attività统计

获取Attività总体统计数据。

• 端点： GET /api/v1/task/stats
• 响应： Indietro total、pending、running、completed、failed 的计数。

检查 API 许可

检查你的LicenzaVuoiSupporto API 访问。

• 端点： GET /api/v1/license/check
• Nota： Starter 计划会IndietroErrore码 40301；Pro/Team/Business 计划可访问 API。