Skip to main content
Management API 是 Scanova 仪表盘中一切操作的编程接口：创建和更新二维码、管理文件夹与标签、读取线索和表单提交内容、拉取分析数据，以及管理共享用户与角色。它与 Scanova 其余 API 接口面运行在不同的主机上，拥有自己独立的身份验证方案。
本页介绍适用于每一个 Management API 端点的整体架构。完整的端点列表请见本页底部链接的各个子页面。

​
快速上手

1

创建一个 Management API 密钥

在登录 Scanova 仪表盘的状态下，通过 仪表盘的密钥管理界面（参见创建与管理 API 密钥）创建一个密钥。创建时请选择一个 environment——sandbox、live、zapier 或 mcp——这一选择对该密钥而言是永久性的，并决定了该密钥发出的每一次请求会检查哪一种套餐配额（见下文）。
2

保存密钥的原始值

创建调用返回的密钥值是您唯一能够看到其完整内容的一次——请妥善保存。事后不存在任何”重新显示”的端点。
3

调用数据端点

将该密钥作为原始 Authorization 请求头的值发送给 api.scanova.io，例如通过 GET /qr/ 列出您的二维码。

​
套餐配额

每一次对数据端点发起的请求都会检查一项与密钥的 environment 绑定的套餐配额：
如果对数据主机的请求返回 401，并附带消息**“Your plan does not have management API quota”**（或 Zapier/MCP 专属的等价消息），说明您的套餐不包含该配额。目前，标准 Pro 套餐并不包含 Management API 访问权限——只有 Free Trial、Enterprise 和 Internal 套餐才包含。如果您认为自己的账户应当拥有该权限，请联系 support@scanova.io。
sandbox 仅仅是一个标签和配额层面的概念——它并不是一个隔离的测试环境。使用 environment: sandbox 创建的密钥，读写的是与 live 密钥相同的真实二维码、文件夹和线索数据。请不要依赖它来存放可随意丢弃的测试数据。
zapier/mcp 密钥还要求调用方客户端的 User-Agent 请求头与其 environment 相匹配才能通过身份验证——zapier 密钥会拒绝除 User-Agent: zapier 之外的请求，mcp 密钥同理。这一规则独立于上文所述的配额检查，单独强制执行。

​
本节内容

列出二维码

GET /qr/ —— 大多数集成项目着手使用的核心数据端点。

创建二维码

POST /qr/ —— 大多数集成项目着手使用的核心数据端点。
完整列表请见侧边栏，包括获取/更新/删除单个二维码、下载二维码图片，以及浏览回收站。

​
相关内容

  • API 参考简介 —— 本概览所属的上级章节。
  • 列出二维码 —— 大多数集成项目着手使用的核心数据端点。
  • 创建二维码 —— 大多数集成项目着手使用的核心数据端点。
  • MCP 概览 —— 一个完全构建于同一 API 之上的集成，使用专属的 mcp environment。