curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
管理 API — 潜在客户与表单
创建表单
POST /forms/
POST
/
forms
/
curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
表单是 Scanova 当前的线索收集与数据采集构建器——比旧版的线索列表功能更为强大,是从二维码扫描中收集访客数据的推荐方式。在此列出或创建表单。
需要一个拥有
MANAGEMENT_API(或 MANAGEMENT_API_SANDBOX)配额的 Management API 密钥,以原始 Authorization 请求头的值发送——参见 Management API 概览。curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
string
必填
表单名称。
object
必填
表单的字段模式——会依据 Scanova 表单构建器的 JSON 模式进行校验。格式错误的数据会在
data 字段下返回 400 错误。string
要在创建时立即关联的二维码
qrid。仅适用于动态(dy)二维码。integer
用于为该表单的公开页面设定样式的已启用主题 ID。省略则使用平台默认主题。
object
在
theme_id(或默认主题)之上叠加的部分主题令牌覆盖项。创建后再关联更多二维码,或整体替换关联集合,都不属于本端点请求体的一部分——这属于仪表盘/内部 API 中一个单独的
qr_ids 链接替换操作,目前尚未在此处开放。相关内容
- 列出表单 — 同一端点的另一个操作。
- 线索列表管理 —— 表单所取代的旧版线索收集功能。
- 列出 / 创建二维码 —— 查找在创建表单时作为
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.
响应
201
Form created
此页面对您有帮助吗?
⌘I