API Status Akun

Halaman ini mendokumentasikan endpoint API untuk menanyakan status semua akun yang dikelola di TikMatrix, termasuk status online/offline perangkat, status login, dan tag.

Daftar akun

Ambil semua akun dengan informasi status yang diperkaya.

• Endpoint: GET /api/v1/accounts

Parameter kueri

Parameter	Tipe	Default	Deskripsi
platform	string	—	Filter berdasarkan platform: tiktok atau instagram
device	string	—	Filter berdasarkan nomor seri perangkat
logined	integer	—	Filter berdasarkan status login: 0 = belum login, 1 = sudah login
status	integer	—	Filter berdasarkan status akun: 0 = aktif, 1 = nonaktif
tag	string	—	Filter berdasarkan tag (cocok persis)
page	integer	1	Nomor halaman (berbasis 1)
page_size	integer	20	Item per halaman (maks 100)

Field respons

Field	Tipe	Deskripsi
accounts	array	Daftar objek akun (lihat di bawah)
total	integer	Jumlah total akun yang cocok dengan filter
page	integer	Nomor halaman saat ini
page_size	integer	Item per halaman

Objek akun

Field	Tipe	Deskripsi
id	integer	ID basis data akun
username	string | null	Nama pengguna media sosial
email	string | null	Alamat email akun
platform	string	Platform: tiktok atau instagram
packagename	string | null	Nama paket aplikasi clone (null = aplikasi default)
device	string | null	Nomor seri perangkat ADB
device_online	boolean	Apakah perangkat sedang terhubung
device_name	string	Nama model perangkat (string kosong saat offline)
logined	integer	0 = belum login, 1 = sudah login
logined_text	string	"logged_in" atau "not_logged_in"
status	integer	0 = aktif, 1 = nonaktif
status_text	string	"enabled" atau "disabled"
tags	string[]	Tag yang ditetapkan ke akun ini

Keamanan

Kata sandi akun tidak pernah disertakan dalam respons API.

Contoh

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

Filter berdasarkan platform dan status login:

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

Filter berdasarkan nomor seri perangkat:

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

Contoh respons

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

Respons error

Status HTTP	Kode	Deskripsi
403	40301	Dilarang — akses API memerlukan paket Pro+
500	50001	Kesalahan server internal