curl --request POST \
--url 'https://management.scanova.io/analytics/qr/?from=2026-07-01&to=2026-08-16&type=qr' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}'
{
"qr": [],
"qr_meta": {
"docs-v2-first-qr-code": {
"qrid": "Q07afe81aa0034c01",
"category": "Website URL",
"category_slug": "url"
}
}
}
二维码分析
POST /analytics/qr/
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/?from=2026-07-01&to=2026-08-16&type=qr' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}'
{
"qr": [],
"qr_meta": {
"docs-v2-first-qr-code": {
"qrid": "Q07afe81aa0034c01",
"category": "Website URL",
"category_slug": "url"
}
}
}
GET 请求会返回 405 Method Not Allowed。查询参数（from、to、type）用于选择日期范围和指标；请求体则用于选择要包含哪些二维码。MANAGEMENT_API（或 MANAGEMENT_API_SANDBOX）配额的 Management API 密钥——参见 Management API 概览——以及账户自身的 QR_ANALYTICS_BASIC 配额。请求 count 指标以外的任何内容还需要 QR_ANALYTICS_ADVANCED；若没有该配额，无论您请求的 type 是什么，请求都会被静默降级为 count。请求
curl --request POST \
--url 'https://management.scanova.io/analytics/qr/?from=2026-07-01&to=2026-08-16&type=qr' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"q": ["Q07afe81aa0034c01"],
"filter_by": "qrid"
}'
{
"qr": [],
"qr_meta": {
"docs-v2-first-qr-code": {
"qrid": "Q07afe81aa0034c01",
"category": "Website URL",
"category_slug": "url"
}
}
}
qr 数组反映的是该二维码在请求的时间窗口内扫描次数为零，而不是发生了错误。qr_meta 是一个额外的 name -> {qrid, category, category_slug} 映射，仅当 qr 出现在请求的 type 中时才会添加，方便调用方从以名称为键的行反查回其 qrid。它是增量式的：调用方已经在解析的各指标键下的数据结构保持不变。查询参数
YYYY-MM-DD），含当天。YYYY-MM-DD），含当天。qr,device,geography。常见取值：count、qr、date、day、time、utm、device、os、browser、handset、geography、geo_location、age。请求 count 以外的任何内容都需要账户的 QR_ANALYTICS_ADVANCED 配额。date、week、month。true 以用于仪表盘概览风格的调用——绕过下文所述的二维码数量/日期范围数据量限制，且不计入账户的”已获取分析数据”活跃度信号。请求体
filter_by。qrid（二维码 ID）、id（内部数字 ID）、tags（标签名称）或 folder（文件夹 ID）之一。响应
响应是一个以每个请求的指标type 为键的对象，如适用还会包含 qr_meta（见上文）。数据结构因指标类型而异——count 返回扫描总数，device/os/browser/geography 返回按该维度的细分数据，而时间序列类型（date/day/time）则返回按 group 分桶的序列数据。
相关内容
- 导出分析数据 —— 将同类聚合指标下载为文件，而不是获取 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.
查询参数
Comma-separated metric types, e.g. qr.
Grouping for time-series metric types, e.g. date/week/month.
Bypasses the volume cap; used by dashboard overview widgets.
请求体
响应
Analytics data, grouped by the requested type(s). A qr_meta name->{qrid, category, category_slug} map is attached whenever qr is among the requested types.
此页面对您有帮助吗？