API de estado de cuentas

Esta página documenta el endpoint de API para consultar el estado de todas las cuentas gestionadas en TikMatrix, incluido el estado en línea/fuera de línea del dispositivo, el estado de inicio de sesión y las etiquetas.

Listar cuentas

Recupera todas las cuentas con información de estado enriquecida.

• Endpoint: GET /api/v1/accounts

Parámetros de consulta

Parámetro	Tipo	Predeterminado	Descripción
platform	string	—	Filtrar por plataforma: tiktok o instagram
device	string	—	Filtrar por número de serie del dispositivo
logined	integer	—	Filtrar por estado de inicio de sesión: 0 = no ha iniciado sesión, 1 = ha iniciado sesión
status	integer	—	Filtrar por estado de la cuenta: 0 = habilitada, 1 = deshabilitada
tag	string	—	Filtrar por etiqueta (coincidencia exacta)
page	integer	1	Número de página (base 1)
page_size	integer	20	Elementos por página (máximo 100)

Campos de respuesta

Campo	Tipo	Descripción
accounts	array	Lista de objetos de cuenta (ver abajo)
total	integer	Número total de cuentas que coinciden con los filtros
page	integer	Número de página actual
page_size	integer	Elementos por página

Objeto de cuenta

Campo	Tipo	Descripción
id	integer	ID de la cuenta en la base de datos
username	string | null	Nombre de usuario de la red social
email	string | null	Dirección de correo electrónico de la cuenta
platform	string	Plataforma: tiktok o instagram
packagename	string | null	Nombre del paquete de la app clonada (null = app predeterminada)
device	string | null	Número de serie del dispositivo ADB
device_online	boolean	Si el dispositivo está conectado actualmente
device_name	string	Nombre del modelo del dispositivo (cadena vacía cuando está fuera de línea)
logined	integer	0 = no ha iniciado sesión, 1 = ha iniciado sesión
logined_text	string	"logged_in" o "not_logged_in"
status	integer	0 = habilitada, 1 = deshabilitada
status_text	string	"enabled" o "disabled"
tags	string[]	Etiquetas asignadas a esta cuenta

Seguridad

La contraseña de la cuenta nunca se incluye en las respuestas de la API.

Ejemplo

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

Filtrar por plataforma y estado de inicio de sesión:

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

Filtrar por número de serie del dispositivo:

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

Respuesta de ejemplo

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

Respuestas de error

Estado HTTP	Código	Descripción
403	40301	Prohibido — el acceso a la API requiere el plan Pro+
500	50001	Error interno del servidor