Kontostatus-API

Diese Seite dokumentiert den API-Endpunkt zum Abfragen des Status aller in TikMatrix verwalteten Konten, einschließlich Online-/Offline-Status des Geräts, Anmeldestatus und Tags.

Konten auflisten

Rufen Sie alle Konten mit erweiterten Statusinformationen ab.

• Endpunkt: GET /api/v1/accounts

Abfrageparameter

Parameter	Typ	Standard	Beschreibung
platform	string	—	Nach Plattform filtern: tiktok oder instagram
device	string	—	Nach Geräteseriennummer filtern
logined	integer	—	Nach Anmeldestatus filtern: 0 = nicht angemeldet, 1 = angemeldet
status	integer	—	Nach Kontostatus filtern: 0 = aktiviert, 1 = deaktiviert
tag	string	—	Nach Tag filtern (exakte Übereinstimmung)
page	integer	1	Seitenzahl (beginnend bei 1)
page_size	integer	20	Einträge pro Seite (maximal 100)

Antwortfelder

Feld	Typ	Beschreibung
accounts	array	Liste von Kontoobjekten (siehe unten)
total	integer	Gesamtzahl der Konten, die den Filtern entsprechen
page	integer	Aktuelle Seitenzahl
page_size	integer	Einträge pro Seite

Kontoobjekt

Feld	Typ	Beschreibung
id	integer	Datenbank-ID des Kontos
username	string | null	Benutzername des sozialen Netzwerks
email	string | null	E-Mail-Adresse des Kontos
platform	string	Plattform: tiktok oder instagram
packagename	string | null	Paketname der Klon-App (null = Standard-App)
device	string | null	ADB-Geräteseriennummer
device_online	boolean	Ob das Gerät derzeit verbunden ist
device_name	string	Modellname des Geräts (leerer String, wenn offline)
logined	integer	0 = nicht angemeldet, 1 = angemeldet
logined_text	string	"logged_in" oder "not_logged_in"
status	integer	0 = aktiviert, 1 = deaktiviert
status_text	string	"enabled" oder "disabled"
tags	string[]	Diesem Konto zugewiesene Tags

Sicherheit

Das Kontopasswort wird niemals in API-Antworten enthalten sein.

Beispiel

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

Nach Plattform und Anmeldestatus filtern:

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

Nach Geräteseriennummer filtern:

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

Beispielantwort

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

Fehlerantworten

HTTP-Status	Code	Beschreibung
403	40301	Verboten — API-Zugriff erfordert den Pro+-Plan
500	50001	Interner Serverfehler