curl --request POST \
--url 'https://management.scanova.io/analytics/qr/raw/?from=2026-07-01&to=2026-08-16&file_format=csv' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output raw-analytics.csv
واجهة الإدارة — التحليلات والخطط
تصدير التحليلات الخام
POST /analytics/qr/raw/
POST
/
analytics
/
qr
/
raw
/
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/raw/?from=2026-07-01&to=2026-08-16&file_format=csv' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output raw-analytics.csv
يصدّر تحليلات خام، لكل عملية مسح — صف واحد لكل حدث مسح، بدلًا من التفصيلات المجمّعة التي تعيدها تحليلات رموز QR وتصدير التحليلات.
نقطة النهاية هذه تعيد دومًا ملفًا ثنائيًا، لا JSON.
هذه نقطة نهاية POST فقط — طلب
GET يعيد 405 Method Not Allowed. مواصفة management-api.json كانت تُدرجها سابقًا كـ GET؛ وقد صُحح ذلك.يتطلب مفتاح Management API بحصة
MANAGEMENT_API — راجع نظرة عامة على Management API — بالإضافة إلى حصة EXPORT_ANALYTICS_REPORT وصلاحية ANALYTICS_CAN_EXPORT_RAW الخاصتين بالحساب (تختلف عن صلاحية ANALYTICS_CAN_EXPORT التي يتطلبها التصدير المجمّع — يمكن أن يملك الدور إحداهما دون الأخرى). الرمز 403 مع الرسالة "Your plan does not have export analytics report quota." يعني أن الخطة لا تتضمن التصدير.الطلب
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/raw/?from=2026-07-01&to=2026-08-16&file_format=csv' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output raw-analytics.csv
معلمات الاستعلام
string
مطلوب
تاريخ البدء (
YYYY-MM-DD)، شامل.string
مطلوب
تاريخ الانتهاء (
YYYY-MM-DD)، شامل.string
مطلوب
csv، xls، أو xlsx. خلافًا لـ تصدير التحليلات، لا تُدعم صيغة pdf هنا. أي قيمة أخرى (أو حذفها) تعيد 400 مع الرسالة "Invalid file format".string
مرِّر
raw_bot لتصدير سجلات مسح محدَّدة كروبوتات فقط بدلًا من كل عمليات المسح. أي قيمة أخرى تُتجاهل — نقطة النهاية هذه تصدّر دائمًا بيانات خامًا بغض النظر عما تمرره هنا.نص الطلب
نفس شكل تحليلات رموز QR —q (مطلوب) وfilter_by (الافتراضي qrid) يحدّدان رموز QR التي تُضمَّن عمليات مسحها الخام، وينطبق نفس حد حجم عدد رموز QR/النطاق الزمني.
array
مطلوب
معرّفات تُحدَّد التصدير ضمن نطاقها — نوع المعرّف يعتمد على
filter_by.string
افتراضي:"qrid"
qrid، id، tags، أو folder.صيغ الاستجابة
- csv
- xls / xlsx
يعيد ملف CSV واحدًا (
text/csv، analytics_raw.csv) بصفوف المسح الخام.يعيد جدول بيانات (
analytics_raw.xlsx) بصفوف المسح الخام، بالإضافة إلى ورقة منفصلة لسجلات تتبع الأحداث الخام إذا كان الحساب يُفعِّل تتبع الأحداث.إذا كان الحساب يُفعِّل تحليلات تتبع الأحداث و لم تكن
file_format هي csv، تُضاف تلقائيًا ورقة/قسم ثانٍ من سجلات تتبع الأحداث الخام (معرّف الجلسة، الطابع الزمني، معرّف/اسم رمز QR، معرّف تتبع الحدث الذي حدّده المستخدم، تجزئة الرابط، الرابط). طلب csv يعيد دومًا سجلات المسح فقط — تُحذف صفوف تتبع الأحداث لهذه الصيغة تحديدًا.ذات صلة
- تحليلات رموز QR — المكافئ المجمّع بصيغة JSON لسجلات المسح الخام هذه.
- تصدير التحليلات — صدّر تفصيلات مقاييس مجمّعة بدلًا من بيانات مسح على مستوى الصف.
- نظرة عامة على Management API — مخطط المصادقة وبنية الحصص التي تنتمي إليها نقطة النهاية هذه.
التفويضات
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. management.scanova.io) — the same key sent to the regular API host will not authenticate.
معلمات الاستعلام
الخيارات المتاحة:
csv, xls, xlsx Pass raw_bot for a bot-only export; any other value is overwritten to raw.
الخيارات المتاحة:
raw_bot الجسم
application/json
الاستجابة
Binary file download — text/csv for csv, spreadsheet mimetype for xls/xlsx.
هل كانت هذه الصفحة مفيدة؟
⌘I