curl --request POST \
--url 'https://api.scanova.io/analytics/report/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv"
}'
{
"id": 59,
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv",
"status": "new",
"report_file": null,
"completed_on": null,
"is_saved": false,
"saved_name": null,
"created": "2026-09-08T10:20:00Z",
"requested_by_name": "Docs"
}
分析与套餐
生成分析报告
POST /analytics/report/
POST
/
analytics
/
report
/
curl --request POST \
--url 'https://api.scanova.io/analytics/report/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv"
}'
{
"id": 59,
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv",
"status": "new",
"report_file": null,
"completed_on": null,
"is_saved": false,
"saved_name": null,
"created": "2026-09-08T10:20:00Z",
"requested_by_name": "Docs"
}
将一个异步任务加入队列，为一组 QR 码、一个标签或一个文件夹生成扫描数据和/或分析报告。
任务入队后调用会立即返回
需要具有
MANAGEMENT_API（或 MANAGEMENT_API_SANDBOX）配额的管理 API 密钥 —— 参见管理 API 概述 —— 以及账户自身的 EXPORT_ANALYTICS_REPORT 配额和 ANALYTICS_CAN_EXPORT_REPORT 权限。string
必填
filter_data 所标识的内容：qrcode、tag 或 folder。string
必填
标识目标的 JSON 编码字符串 —— 例如当
filter_type 为 qrcode 时，一个 qrid 的 JSON 数组。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
叠加在
filter_type/filter_data 之上的可选附加 JSON 筛选负载。boolean
默认值:"false"
从报告中排除被识别为机器人流量的扫描。
boolean
默认值:"false"
是否将此报告保留为可重复使用的已保存预设 —— 参见更新已保存的分析报告。
string
已保存预设的名称，当
is_saved 为 true 时必填。每个账户内必须唯一 —— 重复会返回 400。curl --request POST \
--url 'https://api.scanova.io/analytics/report/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv"
}'
{
"id": 59,
"filter_type": "qrcode",
"filter_data": "[\"Q07afe81aa0034c01\"]",
"start_date": "2026-08-01",
"end_date": "2026-08-31",
"report_type": "both",
"analytics_format": "xlsx",
"scan_format": "csv",
"status": "new",
"report_file": null,
"completed_on": null,
"is_saved": false,
"saved_name": null,
"created": "2026-09-08T10:20:00Z",
"requested_by_name": "Docs"
}
201，status 为 "new" —— 报告本身在后台生成，完成后账户会收到电子邮件通知。请查询列出分析报告以获取 status 和 report_file。
相关内容
- 列出分析报告 —— 查询任务状态。
- 更新已保存的分析报告 —— 重命名或管理已保存的预设。
- 管理 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: YOUR_API_KEY. 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.
此页面对您有帮助吗？