Passa al contenuto principale

Panoramica dell'API Locale

TikMatrix fornisce un'API RESTful locale che consente di gestire le attività in modo programmatico. Questo è utile per integrare TikMatrix nei tuoi sistemi di automazione, creare flussi di lavoro personalizzati o eseguire operazioni in blocco.

Requisiti​

Requisito di Licenza

L'API locale è disponibile solo per gli abbonati ai piani Pro, Team e Business. Il piano Starter non ha accesso all'API.

URL Base​

L'API è in esecuzione sulla tua macchina locale all'indirizzo:

http://localhost:50809/api/v1/
note

La porta 50809 è la porta predefinita. Assicurati che TikMatrix sia in esecuzione prima di effettuare richieste API.

Formato di Risposta​

Tutte le risposte API seguono questo formato:

{
  "code": 0,
  "message": "success",
  "data": { ... }
}

Codici di Risposta​

CodiceDescrizione
0Successo
40001Richiesta non valida - Parametri non validi
40002Richiesta non valida - script_name mancante
40003Richiesta non valida - Script non supportato o stato attività non valido
40004Richiesta non valida - Solo le attività in esecuzione possono essere interrotte
40005Richiesta non valida - task_ids non può essere vuoto
40301Vietato - L'accesso all'API richiede il piano Pro+
40401Non trovato - Risorsa non trovata
50001Errore interno del server

Avvio Rapido​

1. Verifica Accesso API​

Prima di tutto, verifica che la tua licenza supporti l'accesso all'API:

curl http://localhost:50809/api/v1/license/check

Risposta:

{
  "code": 0,
  "message": "success",
  "data": {
    "plan_name": "Pro",
    "api_enabled": true,
    "device_limit": 20,
    "message": "API access enabled"
  }
}

2. Creare un'Attività​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "captions": "Guarda il mio nuovo video! #virale"
    },
    "enable_multi_account": false,
    "start_time": "14:30"
  }'

3. Elenco Attività​

curl http://localhost:50809/api/v1/task?status=0&page=1&page_size=20

Script Disponibili​

Il parametro script_name accetta i seguenti valori:

Nome ScriptDescrizioneSupporto API
postPubblica contenuto✅ Supportato
followSegui utenti✅ Supportato
unfollowSmetti di seguire✅ Supportato
account_warmupRiscalda account✅ Supportato
commentPubblica un commento sui post✅ Supportato
boost_commentMetti mi piace/rispondi ai commenti esistenti✅ Supportato
loginAccedi all'account✅ Supportato
profileAggiorna profilo✅ Supportato
match_accountAbbina account sul dispositivo✅ Supportato
likeMi piace ai post✅ Supportato
viewGuarda un post per una durata✅ Supportato
favoriteSalva un post nei Preferiti✅ Supportato
repostRipubblica video TikTok✅ Supportato
messageMessaggio diretto✅ Supportato
follow_suggestedSegui account suggeriti✅ Supportato
super_marketingCampagna di super marketing✅ Supportato †
scrape_userEstrai dati utente🔜 Prossimamente
† Il super marketing utilizza endpoint dedicati

La campagna di super marketing non viene creata tramite POST /api/v1/task. Funziona su un dataset riutilizzabile di target e ha i propri endpoint dedicati — vedi la Configurazione dello Script Super Marketing.

Stato dell'Attività​

Codice StatoTesto StatoDescrizione
0pendingAttività in attesa di esecuzione
1runningAttività in esecuzione
2completedAttività completata con successo
3failedAttività fallita

Passi Successivi​