curl --request POST \
--url 'https://management.scanova.io/lead/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Trade Show Signup",
"data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}"
}'
{
"id": 205,
"lead_id": "L9c2f4a1e",
"name": "Trade Show Signup",
"created": "2026-08-16T20:44:51.008000+05:30",
"is_active": true,
"usage_count": 0,
"entries_count": 0,
"linked_qrs": [],
"modified": "2026-08-16T20:44:51.008000+05:30",
"data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
"webhooks": []
}
管理 API — 潜在客户与表单
创建线索列表
POST /lead/
POST
/
lead
/
curl --request POST \
--url 'https://management.scanova.io/lead/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Trade Show Signup",
"data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}"
}'
{
"id": 205,
"lead_id": "L9c2f4a1e",
"name": "Trade Show Signup",
"created": "2026-08-16T20:44:51.008000+05:30",
"is_active": true,
"usage_count": 0,
"entries_count": 0,
"linked_qrs": [],
"modified": "2026-08-16T20:44:51.008000+05:30",
"data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
"webhooks": []
}
线索列表是 Scanova 最初的线索收集功能——一个附加在二维码落地页上的表单定义（
data）。在此列出或创建线索列表。
线索列表是一项旧版功能。Scanova 仪表盘现在会将新的线索收集使用场景引导至表单，后者以更强大的构建器覆盖了同样的”从二维码扫描中收集访客数据”使用场景。现有的线索列表会继续正常工作，本端点也不受影响，但除非您确实需要管理已存在的线索列表，否则请针对表单构建新的集成。
需要一个拥有
MANAGEMENT_API（或 MANAGEMENT_API_SANDBOX）配额的 Management API 密钥，以原始 Authorization 请求头的值发送——参见 Management API 概览。curl --request POST \
--url 'https://management.scanova.io/lead/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Trade Show Signup",
"data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}"
}'
{
"id": 205,
"lead_id": "L9c2f4a1e",
"name": "Trade Show Signup",
"created": "2026-08-16T20:44:51.008000+05:30",
"is_active": true,
"usage_count": 0,
"entries_count": 0,
"linked_qrs": [],
"modified": "2026-08-16T20:44:51.008000+05:30",
"data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
"webhooks": []
}
string
必填
线索列表名称，最多 128 个字符。
string
必填
一个 JSON 编码的字符串（而非原始对象），用于描述线索表单的字段。会依据仪表盘线索列表构建器所使用的同一套线索表单模式进行校验——格式错误的 JSON 或违反模式的内容会在
data 字段下返回 400 错误。boolean
默认值:"true"
该表单是否在落地页上渲染。
响应中包含
data 和 webhooks（一份 {id, url, created, modified} 形式的通知 Webhook 列表）——这些字段仅出现在创建/获取所返回的详情数据结构中，不出现在上方的列表端点中。相关内容
- 列出线索列表 — 同一端点的另一个操作。
- 表单管理 —— 当前推荐的线索收集构建器，本旧版功能正被引导迁移至此。
- 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
Lead list created
此页面对您有帮助吗？
⌘I