إنتقل إلى المحتوى الرئيسي

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

توثّق هذه الصفحة نقطة نهاية واجهة برمجة التطبيقات للاستعلام عن حالة جميع الحسابات المُدارة في TikMatrix، بما في ذلك حالة الجهاز متصل/غير متصل، وحالة تسجيل الدخول، والعلامات.

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

استرداد جميع الحسابات مع معلومات حالة محسّنة.

  • نقطة النهاية: GET /api/v1/accounts

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

المعلمةالنوعالافتراضيالوصف
platformstring—التصفية حسب المنصة: tiktok أو instagram
devicestring—التصفية حسب الرقم التسلسلي للجهاز
loginedinteger—التصفية حسب حالة تسجيل الدخول: 0 = غير مسجل الدخول، 1 = مسجل الدخول
statusinteger—التصفية حسب حالة الحساب: 0 = مفعّل، 1 = معطّل
tagstring—التصفية حسب العلامة (مطابقة تامة)
pageinteger1رقم الصفحة (يبدأ من 1)
page_sizeinteger20عدد العناصر في الصفحة (الحد الأقصى 100)

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

الحقلالنوعالوصف
accountsarrayقائمة بكائنات الحساب (انظر أدناه)
totalintegerالعدد الإجمالي للحسابات المطابقة لعوامل التصفية
pageintegerرقم الصفحة الحالي
page_sizeintegerعدد العناصر في الصفحة

كائن الحساب​

الحقلالنوعالوصف
idintegerمعرّف الحساب في قاعدة البيانات
usernamestring | nullاسم المستخدم في وسائل التواصل الاجتماعي
emailstring | nullعنوان البريد الإلكتروني للحساب
platformstringالمنصة: tiktok أو instagram
packagenamestring | nullاسم حزمة التطبيق المستنسخ (null = التطبيق الافتراضي)
devicestring | nullالرقم التسلسلي لجهاز ADB
device_onlinebooleanما إذا كان الجهاز متصلاً حالياً
device_namestringاسم طراز الجهاز (سلسلة فارغة عندما يكون غير متصل)
loginedinteger0 = غير مسجل الدخول، 1 = مسجل الدخول
logined_textstring"logged_in" أو "not_logged_in"
statusinteger0 = مفعّل، 1 = معطّل
status_textstring"enabled" أو "disabled"
tagsstring[]العلامات المعيّنة لهذا الحساب
الأمان

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

مثال​

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