API סטטוס חשבונות

דף זה מתעד את נקודת הקצה של ה-API לשאילתת הסטטוס של כל החשבונות המנוהלים ב-TikMatrix, כולל מצב מקוון/לא מקוון של המכשיר, מצב ההתחברות ותגיות.

רשימת חשבונות

אחזר את כל החשבונות עם מידע סטטוס מורחב.

• נקודת קצה: GET /api/v1/accounts

פרמטרים של השאילתה

פרמטר	סוג	ברירת מחדל	תיאור
platform	string	—	סינון לפי פלטפורמה: tiktok או instagram
device	string	—	סינון לפי המספר הסידורי של המכשיר
logined	integer	—	סינון לפי מצב התחברות: 0 = לא מחובר, 1 = מחובר
status	integer	—	סינון לפי סטטוס החשבון: 0 = פעיל, 1 = מושבת
tag	string	—	סינון לפי תגית (התאמה מלאה)
page	integer	1	מספר עמוד (מבוסס 1)
page_size	integer	20	פריטים לעמוד (מקסימום 100)

שדות תגובה

שדה	סוג	תיאור
accounts	array	רשימת אובייקטי חשבון (ראה להלן)
total	integer	המספר הכולל של חשבונות התואמים למסננים
page	integer	מספר העמוד הנוכחי
page_size	integer	פריטים לעמוד

אובייקט חשבון

שדה	סוג	תיאור
id	integer	מזהה החשבון במסד הנתונים
username	string | null	שם המשתמש ברשת החברתית
email	string | null	כתובת האימייל של החשבון
platform	string	פלטפורמה: tiktok או instagram
packagename	string | null	שם חבילת אפליקציית השיבוט (null = אפליקציית ברירת מחדל)
device	string | null	המספר הסידורי של מכשיר ADB
device_online	boolean	האם המכשיר מחובר כעת
device_name	string	שם דגם המכשיר (מחרוזת ריקה כשהמכשיר לא מקוון)
logined	integer	0 = לא מחובר, 1 = מחובר
logined_text	string	"logged_in" או "not_logged_in"
status	integer	0 = פעיל, 1 = מושבת
status_text	string	"enabled" או "disabled"
tags	string[]	תגיות שהוקצו לחשבון זה

אבטחה

סיסמת החשבון לעולם לא נכללת בתגובות ה-API.

דוגמה

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

סינון לפי פלטפורמה ומצב התחברות:

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

סינון לפי המספר הסידורי של המכשיר:

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

תגובה לדוגמה

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

תגובות שגיאה

סטטוס HTTP	קוד	תיאור
403	40301	אסור — גישת API דורשת תוכנית Pro+
500	50001	שגיאת שרת פנימית