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

تتيح لك واجهة برمجة تطبيقات سجل النشاط تتبع وإدارة سجلات النشاط لأجهزتك وحساباتك. وهذا مفيد لمراقبة الإجراءات التي تنفذها مهام الأتمتة الخاصة بك.

إضافة سجل نشاط

أضف إدخال سجل نشاط جديد.

نقطة النهاية: POST /api/v1/activity_log

محتوى الطلب:

{
  "platform": "tiktok",
  "serial": "device_serial_123",
  "action_type": "post",
  "action_detail": "Published video successfully",
  "username": "user123",
  "timestamp": 1707725000
}

الاستجابة:

{
  "code": 0,
  "message": "success",
  "data": {
    "id": 123
  }
}

الحصول على سجلات النشاط

استرجع سجلات النشاط مع عوامل تصفية اختيارية.

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

معاملات الاستعلام:

المعامل	النوع	مطلوب	الوصف
platform	string	لا	تصفية حسب النظام الأساسي (على سبيل المثال، "tiktok"، "instagram")
serial	string	لا	تصفية حسب الرقم التسلسلي للجهاز
action_type	string	لا	تصفية حسب نوع الإجراء (على سبيل المثال، "post"، "follow"، "comment")
limit	integer	لا	عدد السجلات المراد إرجاعها (الافتراضي: 100، الحد الأقصى: 1000)
offset	integer	لا	عدد السجلات التي سيتم تخطيها للترقيم

مثال على الطلب:

curl "http://localhost:50809/api/v1/activity_log?platform=tiktok&limit=50&offset=0"

الاستجابة:

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": 123,
      "platform": "tiktok",
      "serial": "device_serial_123",
      "action_type": "post",
      "action_detail": "Published video successfully",
      "username": "user123",
      "timestamp": 1707725000
    }
  ]
}

الحصول على عدد سجلات النشاط

احصل على العدد الإجمالي لسجلات النشاط المطابقة لعوامل التصفية.

نقطة النهاية: GET /api/v1/activity_log/count

معاملات الاستعلام:

المعامل	النوع	مطلوب	الوصف
platform	string	لا	تصفية حسب النظام الأساسي
serial	string	لا	تصفية حسب الرقم التسلسلي للجهاز
action_type	string	لا	تصفية حسب نوع الإجراء

مثال على الطلب:

curl "http://localhost:50809/api/v1/activity_log/count?platform=tiktok"

الاستجابة:

{
  "code": 0,
  "message": "success",
  "data": {
    "count": 456
  }
}

حذف سجل النشاط

احذف إدخال سجل نشاط محدد بواسطة المعرف.

نقطة النهاية: DELETE /api/v1/activity_log/{id}

مثال على الطلب:

curl -X DELETE "http://localhost:50809/api/v1/activity_log/123"

الاستجابة:

{
  "code": 0,
  "message": "success",
  "data": {
    "deleted": true,
    "id": 123
  }
}

حذف جميع سجلات النشاط

احذف جميع إدخالات سجل النشاط.

نقطة النهاية: DELETE /api/v1/activity_log/all

مثال على الطلب:

curl -X DELETE "http://localhost:50809/api/v1/activity_log/all"

الاستجابة:

{
  "code": 0,
  "message": "success",
  "data": {
    "deleted": true,
    "message": "All activity logs deleted"
  }
}