Hesap Durumu API'si

Bu sayfa, TikMatrix tarafından yönetilen tüm hesapların durumunu sorgulamak için kullanılan API uç noktasını; cihazın çevrimiçi/çevrimdışı durumu, oturum açma durumu ve etiketler dahil olmak üzere açıklar.

Hesapları Listele

Zenginleştirilmiş durum bilgileriyle tüm hesapları alın.

• Uç nokta: GET /api/v1/accounts

Sorgu Parametreleri

Parametre	Tür	Varsayılan	Açıklama
platform	string	—	Platforma göre filtrele: tiktok veya instagram
device	string	—	Cihaz seri numarasına göre filtrele
logined	integer	—	Oturum açma durumuna göre filtrele: 0 = giriş yapılmadı, 1 = giriş yapıldı
status	integer	—	Hesap durumuna göre filtrele: 0 = etkin, 1 = devre dışı
tag	string	—	Etikete göre filtrele (tam eşleşme)
page	integer	1	Sayfa numarası (1 tabanlı)
page_size	integer	20	Sayfa başına öğe sayısı (en fazla 100)

Yanıt Alanları

Alan	Tür	Açıklama
accounts	array	Hesap nesnelerinin listesi (aşağıya bakın)
total	integer	Filtrelerle eşleşen toplam hesap sayısı
page	integer	Geçerli sayfa numarası
page_size	integer	Sayfa başına öğe sayısı

Hesap Nesnesi

Alan	Tür	Açıklama
id	integer	Hesabın veritabanı kimliği
username	string | null	Sosyal medya kullanıcı adı
email	string | null	Hesap e-posta adresi
platform	string	Platform: tiktok veya instagram
packagename	string | null	Klon uygulama paket adı (null = varsayılan uygulama)
device	string | null	ADB cihaz seri numarası
device_online	boolean	Cihazın şu anda bağlı olup olmadığı
device_name	string	Cihaz model adı (çevrimdışıyken boş dize)
logined	integer	0 = giriş yapılmadı, 1 = giriş yapıldı
logined_text	string	"logged_in" veya "not_logged_in"
status	integer	0 = etkin, 1 = devre dışı
status_text	string	"enabled" veya "disabled"
tags	string[]	Bu hesaba atanan etiketler

Güvenlik

Hesap parolası API yanıtlarına asla dahil edilmez.

Örnek

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

Platforma ve oturum açma durumuna göre filtrele:

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

Cihaz seri numarasına göre filtrele:

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

Örnek Yanıt

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

Hata Yanıtları

HTTP Durumu	Kod	Açıklama
403	40301	Yasak — API erişimi Pro+ planı gerektirir
500	50001	Dahili sunucu hatası