跳到主要内容

账号状态 API

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

账号列表​

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

  • 端点： GET /api/v1/accounts

查询参数​

参数类型默认值描述
platformstring—按平台筛选：tiktok、instagram 或 threads
devicestring—按设备序列号筛选
loginedinteger—按登录状态筛选：0 = 未登录，1 = 已登录
statusinteger—按账号状态筛选：0 = 启用，1 = 禁用
tagstring—按标签筛选（精确匹配）
pageinteger1页码（从 1 开始）
page_sizeinteger20每页条目数（最大 100）

响应字段​

字段类型描述
accountsarray账号对象列表（见下文）
totalinteger匹配筛选条件的账号总数
pageinteger当前页码
page_sizeinteger每页条目数

账号对象​

字段类型描述
idinteger账号数据库 ID
usernamestring | null社交媒体用户名
emailstring | null账号电子邮箱地址
platformstring平台：tiktok、instagram 或 threads
packagenamestring | null分身应用包名（null = 默认应用）
devicestring | nullADB 设备序列号
device_onlineboolean设备当前是否已连接
device_namestring设备型号名称（离线时为空字符串）
loginedinteger0 = 未登录，1 = 已登录
logined_textstring"logged_in" 或 "not_logged_in"
statusinteger0 = 启用，1 = 禁用
status_textstring"enabled" 或 "disabled"
tagsstring[]分配给该账号的标签
安全提示

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 状态代码描述
40340301禁止访问 — API 访问需要 Pro+ 计划
50050001服务器内部错误