Skip to main content
POST
يضع في قائمة الانتظار مهمة غير متزامنة تُنشئ تقرير بيانات مسح و/أو تحليلات يغطي مجموعة من رموز QR أو وسمًا أو مجلدًا.
يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة — بالإضافة إلى حصة EXPORT_ANALYTICS_REPORT وصلاحية ANALYTICS_CAN_EXPORT_REPORT الخاصتين بالحساب.
string
مطلوب
ما الذي تحدده filter_data: qrcode أو tag أو folder.
string
مطلوب
سلسلة مُرمَّزة بصيغة JSON تحدد الهدف (الأهداف) — مثل مصفوفة JSON من qrids عندما تكون filter_type هي qrcode.
string
مطلوب
تاريخ البدء (YYYY-MM-DD).
string
مطلوب
تاريخ الانتهاء (YYYY-MM-DD).
string
افتراضي:"both"
scan_data أو analytics أو both.
string
افتراضي:"csv"
تنسيق الملف لجزء التحليلات: csv أو xls أو xlsx أو png أو jpeg أو pdf.
string
افتراضي:"csv"
تنسيق الملف لجزء بيانات المسح: نفس خيارات analytics_format.
object
حمولة تصفية JSON إضافية اختيارية، تُوضع فوق filter_type/filter_data.
boolean
افتراضي:"false"
يستبعد عمليات المسح المحددة كحركة روبوتات من التقرير.
boolean
افتراضي:"false"
ما إذا كان يجب الاحتفاظ بهذا التقرير كإعداد مسبق محفوظ قابل لإعادة الاستخدام — راجع تحديث تقرير تحليلات محفوظ.
string
اسم للإعداد المسبق المحفوظ، مطلوب إذا كانت is_saved بقيمة true. يجب أن يكون فريدًا لكل حساب — تكراره يُعيد 400.
يُعيد الاستدعاء 201 فورًا بمجرد وضع المهمة في قائمة الانتظار، مع status: "new" — يُنشأ التقرير نفسه في الخلفية، ويتلقى الحساب بريدًا إلكترونيًا عند الاكتمال. استعلِم عن سرد تقارير التحليلات لمعرفة status وreport_file.

ذو صلة

التفويضات

Authorization
string
header
مطلوب

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.

الاستجابة

201 - application/json

Report job queued.