API стану акаунтів

На цій сторінці описано API-ендпоінт для отримання стану всіх акаунтів, якими керує TikMatrix, включно зі статусом пристрою онлайн/офлайн, станом входу та тегами.

Список акаунтів

Отримайте всі акаунти з розширеною інформацією про стан.

• Ендпоінт: GET /api/v1/accounts

Параметри запиту

Параметр	Тип	За замовчуванням	Опис
platform	string	—	Фільтр за платформою: tiktok або instagram
device	string	—	Фільтр за серійним номером пристрою
logined	integer	—	Фільтр за станом входу: 0 = не увійшов, 1 = увійшов
status	integer	—	Фільтр за станом акаунта: 0 = увімкнений, 1 = вимкнений
tag	string	—	Фільтр за тегом (точний збіг)
page	integer	1	Номер сторінки (починаючи з 1)
page_size	integer	20	Елементів на сторінці (максимум 100)

Поля відповіді

Поле	Тип	Опис
accounts	array	Список об’єктів акаунтів (див. нижче)
total	integer	Загальна кількість акаунтів, що відповідають фільтрам
page	integer	Поточний номер сторінки
page_size	integer	Елементів на сторінці

Об’єкт акаунта

Поле	Тип	Опис
id	integer	Ідентифікатор акаунта в базі даних
username	string | null	Ім’я користувача в соцмережі
email	string | null	Адреса електронної пошти акаунта
platform	string	Платформа: tiktok або instagram
packagename	string | null	Назва пакета клонованого застосунку (null = стандартний застосунок)
device	string | null	Серійний номер пристрою ADB
device_online	boolean	Чи підключений пристрій зараз
device_name	string	Назва моделі пристрою (порожній рядок, коли пристрій офлайн)
logined	integer	0 = не увійшов, 1 = увійшов
logined_text	string	"logged_in" або "not_logged_in"
status	integer	0 = увімкнений, 1 = вимкнений
status_text	string	"enabled" або "disabled"
tags	string[]	Теги, призначені цьому акаунту

Безпека

Пароль акаунта ніколи не включається у відповіді API.

Приклад

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

Фільтр за платформою та станом входу:

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

Фільтр за серійним номером пристрою:

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

Приклад відповіді

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

Відповіді з помилками

HTTP-статус	Код	Опис
403	40301	Заборонено — доступ до API потребує плану Pro+
500	50001	Внутрішня помилка сервера