Kontostatus-API

Den här sidan dokumenterar API-slutpunkten för att fråga efter status för alla konton som hanteras i TikMatrix, inklusive enhetens online-/offline-status, inloggningsstatus och taggar.

Lista konton

Hämta alla konton med utökad statusinformation.

• Slutpunkt: GET /api/v1/accounts

Frågeparametrar

Parameter	Typ	Standard	Beskrivning
platform	string	—	Filtrera efter plattform: tiktok eller instagram
device	string	—	Filtrera efter enhetens serienummer
logined	integer	—	Filtrera efter inloggningsstatus: 0 = inte inloggad, 1 = inloggad
status	integer	—	Filtrera efter kontostatus: 0 = aktiverad, 1 = inaktiverad
tag	string	—	Filtrera efter tagg (exakt matchning)
page	integer	1	Sidnummer (1-baserat)
page_size	integer	20	Objekt per sida (max 100)

Svarsfält

Fält	Typ	Beskrivning
accounts	array	Lista över kontoobjekt (se nedan)
total	integer	Totalt antal konton som matchar filtren
page	integer	Aktuellt sidnummer
page_size	integer	Objekt per sida

Kontoobjekt

Fält	Typ	Beskrivning
id	integer	Databas-ID för kontot
username	string | null	Användarnamn på sociala medier
email	string | null	Kontots e-postadress
platform	string	Plattform: tiktok eller instagram
packagename	string | null	Paketnamn för klonad app (null = standardapp)
device	string | null	Serienummer för ADB-enhet
device_online	boolean	Om enheten är ansluten just nu
device_name	string	Modellnamn för enheten (tom sträng när enheten är offline)
logined	integer	0 = inte inloggad, 1 = inloggad
logined_text	string	"logged_in" eller "not_logged_in"
status	integer	0 = aktiverad, 1 = inaktiverad
status_text	string	"enabled" eller "disabled"
tags	string[]	Taggar som tilldelats detta konto

Säkerhet

Kontolösenordet inkluderas aldrig i API-svar.

Exempel

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

Filtrera efter plattform och inloggningsstatus:

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

Filtrera efter enhetens serienummer:

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

Exempelsvar

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

Felsvar

HTTP-status	Kod	Beskrivning
403	40301	Förbjudet — API-åtkomst kräver Pro+-plan
500	50001	Internt serverfel