API statusu kont

Ta strona opisuje endpoint API do sprawdzania statusu wszystkich kont zarządzanych w TikMatrix, w tym statusu online/offline urządzenia, stanu logowania i tagów.

Lista kont

Pobierz wszystkie konta z rozszerzonymi informacjami o statusie.

• Endpoint: GET /api/v1/accounts

Parametry zapytania

Parametr	Typ	Domyślnie	Opis
platform	string	—	Filtruj według platformy: tiktok lub instagram
device	string	—	Filtruj według numeru seryjnego urządzenia
logined	integer	—	Filtruj według stanu logowania: 0 = niezalogowane, 1 = zalogowane
status	integer	—	Filtruj według statusu konta: 0 = włączone, 1 = wyłączone
tag	string	—	Filtruj według tagu (dokładne dopasowanie)
page	integer	1	Numer strony (od 1)
page_size	integer	20	Liczba elementów na stronę (maks. 100)

Pola odpowiedzi

Pole	Typ	Opis
accounts	array	Lista obiektów konta (patrz poniżej)
total	integer	Łączna liczba kont pasujących do filtrów
page	integer	Bieżący numer strony
page_size	integer	Liczba elementów na stronę

Obiekt konta

Pole	Typ	Opis
id	integer	ID konta w bazie danych
username	string | null	Nazwa użytkownika w mediach społecznościowych
email	string | null	Adres e-mail konta
platform	string	Platforma: tiktok lub instagram
packagename	string | null	Nazwa pakietu sklonowanej aplikacji (null = aplikacja domyślna)
device	string | null	Numer seryjny urządzenia ADB
device_online	boolean	Czy urządzenie jest obecnie podłączone
device_name	string	Nazwa modelu urządzenia (pusty ciąg, gdy urządzenie jest offline)
logined	integer	0 = niezalogowane, 1 = zalogowane
logined_text	string	"logged_in" lub "not_logged_in"
status	integer	0 = włączone, 1 = wyłączone
status_text	string	"enabled" lub "disabled"
tags	string[]	Tagi przypisane do tego konta

Bezpieczeństwo

Hasło konta nigdy nie jest uwzględniane w odpowiedziach API.

Przykład

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

Filtruj według platformy i stanu logowania:

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

Filtruj według numeru seryjnego urządzenia:

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

Przykładowa odpowiedź

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

Odpowiedzi błędów

Status HTTP	Kod	Opis
403	40301	Zabronione — dostęp do API wymaga planu Pro+
500	50001	Wewnętrzny błąd serwera