Accountstatus-API

Deze pagina documenteert het API-endpoint voor het opvragen van de status van alle accounts die in TikMatrix worden beheerd, inclusief online/offline-status van het apparaat, inlogstatus en tags.

Accounts weergeven

Haal alle accounts op met verrijkte statusinformatie.

• Endpoint: GET /api/v1/accounts

Queryparameters

Parameter	Type	Standaard	Beschrijving
platform	string	—	Filter op platform: tiktok of instagram
device	string	—	Filter op serienummer van het apparaat
logined	integer	—	Filter op inlogstatus: 0 = niet ingelogd, 1 = ingelogd
status	integer	—	Filter op accountstatus: 0 = ingeschakeld, 1 = uitgeschakeld
tag	string	—	Filter op tag (exacte overeenkomst)
page	integer	1	Paginanummer (vanaf 1)
page_size	integer	20	Items per pagina (maximaal 100)

Responsvelden

Veld	Type	Beschrijving
accounts	array	Lijst met accountobjecten (zie hieronder)
total	integer	Totaal aantal accounts dat overeenkomt met de filters
page	integer	Huidig paginanummer
page_size	integer	Items per pagina

Accountobject

Veld	Type	Beschrijving
id	integer	Database-ID van het account
username	string | null	Gebruikersnaam van sociale media
email	string | null	E-mailadres van het account
platform	string	Platform: tiktok of instagram
packagename	string | null	Pakketnaam van gekloonde app (null = standaardapp)
device	string | null	Serienummer van ADB-apparaat
device_online	boolean	Of het apparaat momenteel is verbonden
device_name	string	Modelnaam van het apparaat (lege tekenreeks wanneer offline)
logined	integer	0 = niet ingelogd, 1 = ingelogd
logined_text	string	"logged_in" of "not_logged_in"
status	integer	0 = ingeschakeld, 1 = uitgeschakeld
status_text	string	"enabled" of "disabled"
tags	string[]	Tags die aan dit account zijn toegewezen

Beveiliging

Het accountwachtwoord wordt nooit opgenomen in API-responses.

Voorbeeld

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

Filter op platform en inlogstatus:

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

Filter op serienummer van het apparaat:

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

Voorbeeldrespons

{
  "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
  }
}

Foutresponses

HTTP-status	Code	Beschrijving
403	40301	Verboden — API-toegang vereist het Pro+-abonnement
500	50001	Interne serverfout