curl -X POST "https://api.scanova.io/user-logs/export/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "fromDate": "01/09/2026 00:00", "toDate": "07/09/2026 23:59" }'
{
"id": 483,
"message": ["User Logs Export is in progress. You will receive an email on completion."]
}
سجلات المستخدم والنشاط
تشغيل تصدير سجلات نشاط المستخدم
POST /user-logs/export/
POST
/
user-logs
/
export
/
curl -X POST "https://api.scanova.io/user-logs/export/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "fromDate": "01/09/2026 00:00", "toDate": "07/09/2026 23:59" }'
{
"id": 483,
"message": ["User Logs Export is in progress. You will receive an email on completion."]
}
يضع في قائمة الانتظار مهمة غير متزامنة تُنشئ ملف CSV لنشاط الحساب (أحداث الإنشاء/التحديث/الحذف وتسجيلات الدخول والمشاركات) لنطاق زمني محدد، على مضيف واجهة برمجة التطبيقات للإدارة (
يُعيد الاستدعاء
يُعاد
api.scanova.io)، مع المصادقة باستخدام مفتاح واجهة برمجة التطبيقات للإدارة الخام الخاص بك.
POST https://api.scanova.io/user-logs/export/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
بداية نطاق التصدير، بصيغة
DD/MM/YYYY HH:MM (نظام 24 ساعة)، غير شامل لهذه اللحظة.string
نهاية نطاق التصدير، بصيغة
DD/MM/YYYY HH:MM (نظام 24 ساعة)، شامل لهذه اللحظة.curl -X POST "https://api.scanova.io/user-logs/export/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "fromDate": "01/09/2026 00:00", "toDate": "07/09/2026 23:59" }'
{
"id": 483,
"message": ["User Logs Export is in progress. You will receive an email on completion."]
}
200 فورًا بمجرد وضع المهمة في قائمة الانتظار — id هو معرّف مهمة التصدير في سرد سجل تصدير سجلات المستخدم، حيث تستعلم عن status. يتلقى الحساب بريدًا إلكترونيًا عند اكتمال التصدير أو فشله.
لا يتم التحقق من
fromDate/toDate بشكل متزامن. لا تؤدي سلسلة تاريخ بصيغة خاطئة إلى 400 هنا — تُنشأ المهمة وتفشل بشكل غير متزامن فقط عندما تحاول عملية المعالجة تحليلها، لتنتهي بـ status: "failed" وبريد إلكتروني بالفشل. تحقق دائمًا من صيغة DD/MM/YYYY HH:MM قبل الإرسال.403 إذا كانت خطة الحساب تفتقر إلى حصة USER_LOGS_EXPORT، أو إذا كان المستخدم المشترك الذي يستدعي هذا الطرف يفتقر إلى صلاحية SHARED_USER_CAN_EXPORT_USER_LOGS:
403
{ "detail": "Your plan does not have user logs quota." }
تُحفظ سجلات التصدير المكتملة وملفات CSV الخاصة بها لمدة 14 يومًا، وبعد ذلك تُحذف تلقائيًا.
ذو صلة
- سرد سجل تصدير سجلات المستخدم — الاستعلام عن حالة المهمة.
- حذف سجل من سجل التصدير — إزالة مهمة مبكرًا.
- نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وقواعد الحصة المطبّقة على هذا الطرف.
التفويضات
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
الاستجابة
200 - application/json
Export job queued.
هل كانت هذه الصفحة مفيدة؟