curl --request POST \
--url 'https://management.scanova.io/analytics/qr/export/?from=2026-07-01&to=2026-08-16&file_format=xlsx' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output analytics.xlsx
واجهة الإدارة — التحليلات والخطط
تصدير التحليلات
POST /analytics/qr/export/
POST
/
analytics
/
qr
/
export
/
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/export/?from=2026-07-01&to=2026-08-16&file_format=xlsx' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output analytics.xlsx
يصدّر تحليلات مجمّعة — كل نوع مقياس تسمح به خطة الحساب (
نقطة النهاية هذه تعيد دومًا ملفًا ثنائيًا، لا JSON — راجع صيغ الاستجابة أدناه.
count، date، qr، utm، device، os، browser، geography، والمزيد) — كملف قابل للتنزيل، بدلًا من حمولة JSON واحدة محصورة بنوع (type) واحد كما يتطلب تحليلات رموز QR.
هذه نقطة نهاية POST فقط — طلب
GET يعيد 405 Method Not Allowed. مواصفة management-api.json كانت تُدرجها سابقًا كـ GET؛ وقد صُحح ذلك.يتطلب مفتاح Management API بحصة
MANAGEMENT_API — راجع نظرة عامة على Management API — بالإضافة إلى حصة EXPORT_ANALYTICS_REPORT وصلاحية ANALYTICS_CAN_EXPORT الخاصتين بالحساب. الرمز 403 مع الرسالة “Your plan does not have export analytics report quota.” يعني أن الخطة لا تتضمن التصدير.الطلب
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/export/?from=2026-07-01&to=2026-08-16&file_format=xlsx' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}' \
--output analytics.xlsx
معلمات الاستعلام
string
مطلوب
تاريخ البدء (
YYYY-MM-DD)، شامل.string
مطلوب
تاريخ الانتهاء (
YYYY-MM-DD)، شامل.string
مطلوب
csv، xls، xlsx، أو pdf. أي قيمة أخرى (أو حذفها) تعيد 400 مع الرسالة "Invalid file format".boolean
افتراضي:"false"
يستبعد عمليات المسح المحدَّدة كحركة روبوتات (bot) من التصدير.
نص الطلب
نفس شكل تحليلات رموز QR:array
مطلوب
معرّفات تُحدَّد التصدير ضمن نطاقها — نوع المعرّف يعتمد على
filter_by.string
افتراضي:"qrid"
qrid، id، tags، أو folder.صيغ الاستجابة
- csv
- xls / xlsx
- pdf
يعيد أرشيف ZIP (
application/zip، analytics.zip) يحتوي على ملف CSV واحد لكل نوع مقياس — وليس ملف CSV مسطحًا واحدًا. هذه غرابة حقيقية في صيغة التصدير: طلب csv يمنحك ملف zip، لا ملف .csv مباشرة.يعيد جدول بيانات واحد (
analytics.xlsx) بورقة واحدة لكل نوع مقياس.يعيد تقرير تحليلات PDF مُصيَّر (
application/pdf، analytics.pdf) — ملخص منسّق بدلًا من أوراق خام لكل مقياس.إذا كان الحساب يُفعِّل تحليلات تتبع الأحداث، تُضاف مقاييس
count/engagement الخاصة به تلقائيًا كأوراق/ملفات إضافية في التصدير نفسه — دون الحاجة لأي معلمة إضافية.رغم أن رسالة الخطأ الأساسية تقترح “generate Analytics Export instead”، تفرض نقطة النهاية هذه نفس حد حجم عدد رموز QR/النطاق الزمني الموجود في تحليلات رموز QR بالضبط — جميع نقاط نهاية التحليلات تتشارك مسار كود التحقق من صحة الطلب نفسه. إذا واجهت الخطأ
400 تحت q، ضيّق q أو النطاق الزمني؛ التبديل إلى نقطة النهاية هذه وحدها لن يتجنبه.ذات صلة
- تحليلات رموز 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, pdf الجسم
application/json
الاستجابة
Binary file download — application/zip for csv, spreadsheet mimetype for xls/xlsx, application/pdf for pdf.
هل كانت هذه الصفحة مفيدة؟
⌘I