Passa al contenuto principale

API di Gestione Attività

Questa pagina documenta tutti gli endpoint API disponibili per gestire le attività in TikMatrix.

Crea Attività​

Crea una nuova attività per uno o più dispositivi o nomi utente.

  • Endpoint: POST /api/v1/task
  • Content-Type: application/json

Parametri della Richiesta​

L'API supporta due modalità per creare attività:

Modalità 1: basata su dispositivo - usa serials per creare attività per i dispositivi Modalità 2: basata su nome utente - usa usernames per creare attività direttamente per account specifici

ParametroTipoObbligatorioDescrizione
serialsstring[]CondizionaleArray di numeri di serie dei dispositivi (obbligatorio se usernames non è fornito)
usernamesstring[]CondizionaleArray di nomi utente per cui creare le attività (obbligatorio se serials non è fornito). Se fornito, le attività vengono create direttamente per questi account.
script_namestringSìNome dello script da eseguire
script_configobjectSìParametri di configurazione per lo script (vedi la documentazione specifica dello script)
enable_multi_accountbooleanNoAbilita la modalità multi-account (predefinito: false). Applicabile solo in modalità basata su dispositivo.
start_timestringNoOra di inizio pianificata nel formato "HH:MM"
close_appbooleanNoSe forzare la chiusura dell'app target dopo il termine dell'attività (predefinito: true). Imposta a false per lasciare l'app in esecuzione una volta completata l'attività.
platformstringNoPiattaforma target (tiktok o instagram). Usato solo da TikMatrix Pro; ignorato dalle build a piattaforma singola.
forcebooleanNoIgnora la protezione di prontezza dell'Auto WakeUp Agent (uiautomator) (predefinito: false). Quando l'agent è disabilitato nelle Impostazioni, la creazione dell'attività viene rifiutata con l'errore 40006 a meno che force non sia true — rispecchiando l'opzione "Continua comunque" nell'interfaccia desktop.

Script Supportati​

Nome ScriptDescrizioneDocumentazione
postPubblica video o immagini su TikTok/InstagramConfigurazione Script Post
followSegui o smetti di seguire utentiConfigurazione Script Follow
unfollowSmetti di seguire utentiConfigurazione Script Unfollow
account_warmupRiscalda gli accountConfigurazione Script Account Warmup
commentPubblica un nuovo commento sui postConfigurazione Script Comment
boost_commentMetti mi piace / rispondi ai commenti esistentiConfigurazione Script Boost Comment (Reply)
loginAccedi all'accountConfigurazione Script Login
profileAggiorna il profiloConfigurazione Script Profile
match_accountAbbina gli account sul dispositivoConfigurazione Script Match Account
likeMetti mi piace ai postConfigurazione Script Like
viewGuarda un post per una durataConfigurazione Script View
favoriteSalva un post nei PreferitiConfigurazione Script Favorite
repostReposta video TikTokConfigurazione Script Repost
messageInvia messaggi direttiConfigurazione Script Message
follow_suggestedSegui account suggeritiConfigurazione 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": "Check out my new video! #viral #fyp",
      "material_list": ["C:/Videos/video1.mp4"],
      "upload_wait_time": 60
    }
  }'

Per i parametri dettagliati di script_config e altri esempi, vedi Configurazione Script Post e Configurazione Script Follow.

Mantenere l'app aperta dopo un'attività​

Per impostazione predefinita, l'app target viene forzata a chiudersi una volta terminata l'attività, sia per rispecchiare il comportamento nell'app sia per liberare le risorse del dispositivo. Passa "close_app": false per lasciare l'app in esecuzione dopo il completamento dell'attività — utile quando si concatenano attività o si ispeziona 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
  }'

Risposta​

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

Auto WakeUp Agent disabilitato​

Quando l'Auto WakeUp Agent è disattivato nelle Impostazioni, la creazione dell'attività viene rifiutata per impostazione predefinita — come l'avviso nell'interfaccia desktop — perché le attività create non verrebbero mai eseguite finché l'agent non viene riattivato:

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" }
  }'
{
  "code": 40006,
  "message": "uiautomator (Auto WakeUp Agent) is disabled: created tasks will not execute until it is re-enabled in Settings. Pass \"force\": true to create anyway.",
  "data": null
}

Passa "force": true per creare comunque le attività (equivalente a "Continua comunque" nell'interfaccia).

Elenca Attività​

Interroga le attività con filtri opzionali.

  • Endpoint: GET /api/v1/task
ParametroTipoObbligatorioDescrizione
statusintegerNoFiltra per stato (0=in attesa, 1=in esecuzione, 2=completato, 3=fallito)
serialstringNoFiltra per numero di serie del dispositivo
script_namestringNoFiltra per nome dello script
sourcestringNoFiltra per origine ("ui" o "api")
pageintegerNoNumero di pagina (predefinito: 1)
page_sizeintegerNoElementi per pagina (predefinito: 20, massimo: 100)

Ottieni Dettagli Attività​

Ottieni informazioni dettagliate su un'attività specifica.

  • Endpoint: GET /api/v1/task/{task_id}

Elimina Attività​

Elimina un'attività. Se l'attività è in esecuzione, verrà prima interrotta.

  • Endpoint: DELETE /api/v1/task/{task_id}

Elimina Attività in Blocco​

Elimina più attività contemporaneamente. Le attività in esecuzione verranno prima interrotte.

  • Endpoint: DELETE /api/v1/task/batch
  • Body: { "task_ids": [1, 2, 3] }

Interrompi Attività​

Interrompi un'attività in esecuzione.

  • Endpoint: POST /api/v1/task/{task_id}/stop

Riprova Attività Fallita​

Riprova un'attività fallita.

  • Endpoint: POST /api/v1/task/{task_id}/retry

Riprova Tutte le Attività Fallite​

Riprova tutte le attività fallite contemporaneamente.

  • Endpoint: POST /api/v1/task/retry-all

Ottieni Statistiche Attività​

Ottieni statistiche su tutte le attività.

  • Endpoint: GET /api/v1/task/stats
  • Risposta: restituisce i conteggi totali, in attesa, in esecuzione, completate e fallite.

Verifica Licenza API​

Verifica se la tua licenza supporta l'accesso API.

  • Endpoint: GET /api/v1/license/check
  • Nota: il piano Starter restituisce il codice errore 40301. I piani Pro, Team e Business hanno accesso API.