curl --request GET \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 375,
"form_id": "F7e1b1ad8f8d040e9",
"name": "docs-v2-contact-form",
"created_by": "Docs",
"created": "2026-08-16T20:33:41.950697+05:30",
"form_url": "https://new.scnv.io/form/F7e1b1ad8f8d040e9",
"is_active": true,
"usage_count": 1,
"linked_qrs": [
{
"qr_code__id": 9021,
"qr_code__qrid": "Q07afe81aa0034c01",
"qr_code__name": "docs-v2-first-qr-code",
"qr_code__qr_type": "dy",
"qr_code__is_active": true,
"qr_code__published_at": "2026-08-16T15:03:11.884000+05:30",
"qr_code__category__slug": "url",
"dynamic_url_object__short_url": "https://new.scnv.io/s/AbC123",
"qr_code__is_currently_draft": false
}
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-08-16T20:33:41.950697+05:30"
},
{
"id": 374,
"form_id": "F1a2b3c4d5e6f7g8h",
"name": "Event RSVP",
"created_by": "Docs",
"created": "2026-08-01T09:15:02.001000+05:30",
"form_url": "https://new.scnv.io/form/F1a2b3c4d5e6f7g8h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-01T09:15:02.001000+05:30"
}
]
}
管理 API — 潜在客户与表单
列出表单
GET /forms/
GET
/
forms
/
curl --request GET \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 375,
"form_id": "F7e1b1ad8f8d040e9",
"name": "docs-v2-contact-form",
"created_by": "Docs",
"created": "2026-08-16T20:33:41.950697+05:30",
"form_url": "https://new.scnv.io/form/F7e1b1ad8f8d040e9",
"is_active": true,
"usage_count": 1,
"linked_qrs": [
{
"qr_code__id": 9021,
"qr_code__qrid": "Q07afe81aa0034c01",
"qr_code__name": "docs-v2-first-qr-code",
"qr_code__qr_type": "dy",
"qr_code__is_active": true,
"qr_code__published_at": "2026-08-16T15:03:11.884000+05:30",
"qr_code__category__slug": "url",
"dynamic_url_object__short_url": "https://new.scnv.io/s/AbC123",
"qr_code__is_currently_draft": false
}
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-08-16T20:33:41.950697+05:30"
},
{
"id": 374,
"form_id": "F1a2b3c4d5e6f7g8h",
"name": "Event RSVP",
"created_by": "Docs",
"created": "2026-08-01T09:15:02.001000+05:30",
"form_url": "https://new.scnv.io/form/F1a2b3c4d5e6f7g8h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-01T09:15:02.001000+05:30"
}
]
}
表单是 Scanova 当前的线索收集与数据采集构建器——比旧版的线索列表功能更为强大,是从二维码扫描中收集访客数据的推荐方式。在此列出或创建表单。
此处的
需要一个拥有
MANAGEMENT_API(或 MANAGEMENT_API_SANDBOX)配额的 Management API 密钥,以原始 Authorization 请求头的值发送——参见 Management API 概览。curl --request GET \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 375,
"form_id": "F7e1b1ad8f8d040e9",
"name": "docs-v2-contact-form",
"created_by": "Docs",
"created": "2026-08-16T20:33:41.950697+05:30",
"form_url": "https://new.scnv.io/form/F7e1b1ad8f8d040e9",
"is_active": true,
"usage_count": 1,
"linked_qrs": [
{
"qr_code__id": 9021,
"qr_code__qrid": "Q07afe81aa0034c01",
"qr_code__name": "docs-v2-first-qr-code",
"qr_code__qr_type": "dy",
"qr_code__is_active": true,
"qr_code__published_at": "2026-08-16T15:03:11.884000+05:30",
"qr_code__category__slug": "url",
"dynamic_url_object__short_url": "https://new.scnv.io/s/AbC123",
"qr_code__is_currently_draft": false
}
],
"entries_count": 3,
"conversion": 12.5,
"modified": "2026-08-16T20:33:41.950697+05:30"
},
{
"id": 374,
"form_id": "F1a2b3c4d5e6f7g8h",
"name": "Event RSVP",
"created_by": "Docs",
"created": "2026-08-01T09:15:02.001000+05:30",
"form_url": "https://new.scnv.io/form/F1a2b3c4d5e6f7g8h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-01T09:15:02.001000+05:30"
}
]
}
count、results[0] 反映的是针对一个拥有两个表单的测试账户所核实的真实响应。
boolean
筛选为已启用或已停用的表单。
string
created 的下限(含当天,YYYY-MM-DD)。string
created 的上限(含当天,YYYY-MM-DD)。string
对表单名称进行子字符串匹配。
string
created 或 name,前缀 - 表示降序。响应字段(每个条目)
integer
string
稳定的表单标识符,用于公开表单 URL,也作为获取/更新/删除端点的路径参数。
string
string | null
创建该表单的用户显示名称。
string
该表单渲染所在的公开 URL。
boolean
integer
当前关联到此表单的二维码数量。
array
关联到此表单的二维码,每个条目都带有该二维码的
qr_code__* 字段及其解析出的短链接。integer | null
已收到的提交总数。如果无法计算(例如跨数据库的跟踪存储不可访问),则为
null。number | null
关联二维码的扫描中,最终形成提交的百分比。如果尚无扫描记录,则为
null。string
string
相关内容
- 创建表单 — 同一端点的另一个操作。
- 线索列表管理 —— 表单所取代的旧版线索收集功能。
- 列出 / 创建二维码 —— 查找在创建表单时作为
qr_id传入的qrid。 - 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.
响应
200
List of forms
此页面对您有帮助吗?
⌘I