واجهة برمجة تطبيقات حالة الحسابات

توثّق هذه الصفحة نقطة نهاية واجهة برمجة التطبيقات للاستعلام عن حالة جميع الحسابات المُدارة في 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[]	العلامات المعيّنة لهذا الحساب

الأمان

لا يتم تضمين كلمة مرور الحساب أبداً في استجابات واجهة برمجة التطبيقات.

مثال

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	محظور — يتطلب الوصول إلى واجهة برمجة التطبيقات خطة Pro+
500	50001	خطأ داخلي في الخادم

قائمة الحسابات​

معلمات الاستعلام​

حقول الاستجابة​

كائن الحساب​

مثال​

استجابة نموذجية​

استجابات الخطأ​