API trạng thái tài khoản

Trang này mô tả endpoint API để truy vấn trạng thái của tất cả tài khoản được quản lý trong TikMatrix, bao gồm trạng thái trực tuyến/ngoại tuyến của thiết bị, trạng thái đăng nhập và thẻ.

Liệt kê tài khoản

Lấy tất cả tài khoản với thông tin trạng thái mở rộng.

• Điểm cuối: GET /api/v1/accounts

Tham số truy vấn

Tham số	Kiểu	Mặc định	Mô tả
platform	string	—	Lọc theo nền tảng: tiktok, instagram hoặc threads
device	string	—	Lọc theo số sê-ri thiết bị
logined	integer	—	Lọc theo trạng thái đăng nhập: 0 = chưa đăng nhập, 1 = đã đăng nhập
status	integer	—	Lọc theo trạng thái tài khoản: 0 = đã bật, 1 = đã tắt
tag	string	—	Lọc theo thẻ (khớp chính xác)
page	integer	1	Số trang (bắt đầu từ 1)
page_size	integer	20	Số mục mỗi trang (tối đa 100)

Trường phản hồi

Trường	Kiểu	Mô tả
accounts	array	Danh sách đối tượng tài khoản (xem bên dưới)
total	integer	Tổng số tài khoản khớp với bộ lọc
page	integer	Số trang hiện tại
page_size	integer	Số mục mỗi trang

Đối tượng tài khoản

Trường	Kiểu	Mô tả
id	integer	ID tài khoản trong cơ sở dữ liệu
username	string | null	Tên người dùng mạng xã hội
email	string | null	Địa chỉ email của tài khoản
platform	string	Nền tảng: tiktok, instagram hoặc threads
packagename	string | null	Tên gói ứng dụng clone (null = ứng dụng mặc định)
device	string | null	Số sê-ri thiết bị ADB
device_online	boolean	Thiết bị hiện có đang được kết nối hay không
device_name	string	Tên model thiết bị (chuỗi rỗng khi ngoại tuyến)
logined	integer	0 = chưa đăng nhập, 1 = đã đăng nhập
logined_text	string	"logged_in" hoặc "not_logged_in"
status	integer	0 = đã bật, 1 = đã tắt
status_text	string	"enabled" hoặc "disabled"
tags	string[]	Các thẻ được gán cho tài khoản này

Bảo mật

Mật khẩu tài khoản không bao giờ được đưa vào phản hồi API.

Ví dụ

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

Lọc theo nền tảng và trạng thái đăng nhập:

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

Lọc theo số sê-ri thiết bị:

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

Phản hồi mẫu

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

Phản hồi lỗi

Trạng thái HTTP	Mã	Mô tả
403	40301	Bị cấm — quyền truy cập API yêu cầu gói Pro+
500	50001	Lỗi máy chủ nội bộ