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

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

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

Получите все аккаунты с расширенной информацией о статусе.

• Endpoint: GET /api/v1/accounts

Параметры запроса

Параметр	Тип	По умолчанию	Описание
platform	string	—	Фильтр по платформе: tiktok, instagram или threads
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	ID аккаунта в базе данных
username	string | null	Имя пользователя в соцсети
email	string | null	Адрес электронной почты аккаунта
platform	string	Платформа: tiktok, instagram или threads
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	Внутренняя ошибка сервера