API 文档

接入方式概览

ClawQR 提供三种接入方式，可按团队的技术能力选择：

• REST API：用于批量生成二维码、创建短链、拉取扫码与线索数据；
• Webhook 回调：扫码、留资等事件发生时推送到你的服务器；
• MCP 协议：把二维码 Agent 能力接入支持 MCP 的 AI 客户端与工作流。

接入流程

1. 发送邮件至 contact@clawqr.com，说明公司、业务场景和预计调用量；
2. 我们开通测试环境账号，并提供 API Key 与接口文档；
3. 在测试环境联调通过后切换到正式环境。

API Key 属于敏感凭证，请通过服务端保存与调用，不要写在前端代码或公开仓库中。

能力范围

• 二维码与短链：创建、更新目标地址、设置有效期；
• 扫码事件：扫码时间、来源渠道、设备与地区等基础信息（不含个人身份信息）；
• 线索数据：扫码产生的线索记录、跟进状态查询；
• Agent 配置：按场景配置问答与话术模板。

请求示例（示例代码，正式域名与参数以商务提供为准）

POST /v1/qrcodes
Content-Type: application/json
Authorization: Bearer <YOUR_API_KEY>

{
  "name": "sample-catalog-2026",
  "target_url": "https://example.com/catalog",
  "ttl_hours": 24
}

服务与支持

工作日 9:00 - 18:00（北京时间 UTC+8）。技术对接问题请发送邮件至 contact@clawqr.com，并在邮件中附上调用时间、接口路径与返回的错误信息。