API d’état des comptes

Cette page documente l’endpoint API permettant d’interroger l’état de tous les comptes gérés dans TikMatrix, y compris l’état en ligne/hors ligne de l’appareil, l’état de connexion et les tags.

Lister les comptes

Récupérez tous les comptes avec des informations d’état enrichies.

• Endpoint : GET /api/v1/accounts

Paramètres de requête

Paramètre	Type	Par défaut	Description
platform	string	—	Filtrer par plateforme : tiktok ou instagram
device	string	—	Filtrer par numéro de série de l’appareil
logined	integer	—	Filtrer par état de connexion : 0 = non connecté, 1 = connecté
status	integer	—	Filtrer par état du compte : 0 = activé, 1 = désactivé
tag	string	—	Filtrer par tag (correspondance exacte)
page	integer	1	Numéro de page (à partir de 1)
page_size	integer	20	Éléments par page (max 100)

Champs de réponse

Champ	Type	Description
accounts	array	Liste des objets compte (voir ci-dessous)
total	integer	Nombre total de comptes correspondant aux filtres
page	integer	Numéro de page actuel
page_size	integer	Éléments par page

Objet compte

Champ	Type	Description
id	integer	ID du compte dans la base de données
username	string | null	Nom d’utilisateur du réseau social
email	string | null	Adresse e-mail du compte
platform	string	Plateforme : tiktok ou instagram
packagename	string | null	Nom du package de l’app clonée (null = application par défaut)
device	string | null	Numéro de série de l’appareil ADB
device_online	boolean	Indique si l’appareil est actuellement connecté
device_name	string	Nom du modèle de l’appareil (chaîne vide lorsqu’il est hors ligne)
logined	integer	0 = non connecté, 1 = connecté
logined_text	string	"logged_in" ou "not_logged_in"
status	integer	0 = activé, 1 = désactivé
status_text	string	"enabled" ou "disabled"
tags	string[]	Tags attribués à ce compte

Sécurité

Le mot de passe du compte n’est jamais inclus dans les réponses API.

Exemple

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

Filtrer par plateforme et état de connexion :

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

Filtrer par numéro de série de l’appareil :

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

Exemple de réponse

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

Réponses d’erreur

Statut HTTP	Code	Description
403	40301	Interdit — l’accès à l’API nécessite l’offre Pro+
500	50001	Erreur interne du serveur