账号状态 API

本页介绍用于查询 TikMatrix 中所有已管理账号状态的 API 端点，包括设备在线/离线状态、登录状态和标签。

账号列表

获取带有增强状态信息的所有账号。

• 端点： 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	账号数据库 ID
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	服务器内部错误