API de status das contas

Esta página documenta o endpoint da API para consultar o status de todas as contas gerenciadas no TikMatrix, incluindo o status online/offline do dispositivo, o estado de login e as tags.

Listar contas

Recupere todas as contas com informações de status enriquecidas.

• Endpoint: GET /api/v1/accounts

Parâmetros de consulta

Parâmetro	Tipo	Padrão	Descrição
platform	string	—	Filtrar por plataforma: tiktok, instagram ou threads
device	string	—	Filtrar pelo número de série do dispositivo
logined	integer	—	Filtrar pelo estado de login: 0 = não conectado, 1 = conectado
status	integer	—	Filtrar pelo status da conta: 0 = habilitada, 1 = desabilitada
tag	string	—	Filtrar por tag (correspondência exata)
page	integer	1	Número da página (baseado em 1)
page_size	integer	20	Itens por página (máximo 100)

Campos de resposta

Campo	Tipo	Descrição
accounts	array	Lista de objetos de conta (veja abaixo)
total	integer	Número total de contas que correspondem aos filtros
page	integer	Número da página atual
page_size	integer	Itens por página

Objeto da conta

Campo	Tipo	Descrição
id	integer	ID da conta no banco de dados
username	string | null	Nome de usuário da rede social
email	string | null	Endereço de e-mail da conta
platform	string	Plataforma: tiktok, instagram ou threads
packagename	string | null	Nome do pacote do app clonado (null = app padrão)
device	string | null	Número de série do dispositivo ADB
device_online	boolean	Indica se o dispositivo está conectado no momento
device_name	string	Nome do modelo do dispositivo (string vazia quando offline)
logined	integer	0 = não conectado, 1 = conectado
logined_text	string	"logged_in" ou "not_logged_in"
status	integer	0 = habilitada, 1 = desabilitada
status_text	string	"enabled" ou "disabled"
tags	string[]	Tags atribuídas a esta conta

Segurança

A senha da conta nunca é incluída nas respostas da API.

Exemplo

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

Filtrar por plataforma e estado de login:

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

Filtrar pelo número de série do dispositivo:

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

Resposta de exemplo

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

Respostas de erro

Status HTTP	Código	Descrição
403	40301	Proibido — o acesso à API exige o plano Pro+
500	50001	Erro interno do servidor