API stato account

Questa pagina documenta l’endpoint API per interrogare lo stato di tutti gli account gestiti in TikMatrix, inclusi lo stato online/offline del dispositivo, lo stato di accesso e i tag.

Elenco account

Recupera tutti gli account con informazioni di stato arricchite.

• Endpoint: GET /api/v1/accounts

Parametri di query

Parametro	Tipo	Predefinito	Descrizione
platform	string	—	Filtra per piattaforma: tiktok o instagram
device	string	—	Filtra per numero di serie del dispositivo
logined	integer	—	Filtra per stato di accesso: 0 = non connesso, 1 = connesso
status	integer	—	Filtra per stato dell’account: 0 = abilitato, 1 = disabilitato
tag	string	—	Filtra per tag (corrispondenza esatta)
page	integer	1	Numero di pagina (a partire da 1)
page_size	integer	20	Elementi per pagina (massimo 100)

Campi della risposta

Campo	Tipo	Descrizione
accounts	array	Elenco di oggetti account (vedi sotto)
total	integer	Numero totale di account che corrispondono ai filtri
page	integer	Numero di pagina corrente
page_size	integer	Elementi per pagina

Oggetto account

Campo	Tipo	Descrizione
id	integer	ID del database dell’account
username	string | null	Nome utente del social media
email	string | null	Indirizzo e-mail dell’account
platform	string	Piattaforma: tiktok o instagram
packagename	string | null	Nome del pacchetto dell’app clonata (null = app predefinita)
device	string | null	Numero di serie del dispositivo ADB
device_online	boolean	Indica se il dispositivo è attualmente connesso
device_name	string	Nome del modello del dispositivo (stringa vuota quando offline)
logined	integer	0 = non connesso, 1 = connesso
logined_text	string	"logged_in" o "not_logged_in"
status	integer	0 = abilitato, 1 = disabilitato
status_text	string	"enabled" o "disabled"
tags	string[]	Tag assegnati a questo account

Sicurezza

La password dell’account non è mai inclusa nelle risposte API.

Esempio

curl "http://localhost:50809/api/v1/accounts?page=1&page_size=20"

Filtra per piattaforma e stato di accesso:

curl "http://localhost:50809/api/v1/accounts?platform=tiktok&logined=1&page=1&page_size=50"

Filtra per numero di serie del dispositivo:

curl "http://localhost:50809/api/v1/accounts?device=emulator-5554"

Risposta di esempio

{
  "code": 0,
  "message": "success",
  "data": {
    "accounts": [
      {
        "id": 1,
        "username": "my_tiktok_user",
        "email": "user@example.com",
        "platform": "tiktok",
        "packagename": null,
        "device": "emulator-5554",
        "device_online": true,
        "device_name": "sdk_gphone64_x86_64",
        "logined": 1,
        "logined_text": "logged_in",
        "status": 0,
        "status_text": "enabled",
        "tags": ["batch-a", "vip"]
      },
      {
        "id": 2,
        "username": "another_user",
        "email": null,
        "platform": "tiktok",
        "packagename": "com.zhiliaoapp.musically.clone1",
        "device": "192.168.1.101:5555",
        "device_online": false,
        "device_name": "",
        "logined": 0,
        "logined_text": "not_logged_in",
        "status": 1,
        "status_text": "disabled",
        "tags": []
      }
    ],
    "total": 2,
    "page": 1,
    "page_size": 20
  }
}

Risposte di errore

Stato HTTP	Codice	Descrizione
403	40301	Vietato — l’accesso API richiede il piano Pro+
500	50001	Errore interno del server