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
管理 API — 分析与套餐
导出分析数据
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 等）——导出为一个可下载的文件，而不是像 二维码分析 那样要求限定在单一 type 的 JSON 响应。
这是一个仅支持 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。任何其他值（或省略该参数）都会返回一个附带 "Invalid file format" 的 400 错误。boolean
默认值:"false"
从导出结果中排除被识别为机器人流量的扫描。
请求体
与 二维码分析 的数据结构相同：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”，该端点强制执行与 二维码分析 完全相同的二维码数量/日期范围数据量限制——所有分析类端点共享同一套请求校验代码路径。如果您在
q 字段下遇到了 400 错误，请缩小 q 或日期范围；仅仅切换到本端点并不能避开这个限制。相关内容
- 二维码分析 —— 本导出功能的 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 响应
Binary file download — application/zip for csv, spreadsheet mimetype for xls/xlsx, application/pdf for pdf.
此页面对您有帮助吗？
⌘I