文档
面向 Abundera QR Pro 动态 QR 平台的 REST API。创建码、重新设置目标地址、拉取扫描分析数据、管理团队并接入 Webhook。
API 规范
Abundera QR Pro API 遵循 OpenAPI 3.1。浏览交互式参考文档、下载规范,或将其导入你常用的 API 客户端。
交互式 API 参考文档 →
包含每个端点的请求和响应模式、参数,可在浏览器中直接试用。由 Scalar 提供支持。
OpenAPI 3.1(JSON)
完整规范,91 个面向客户的端点。最适合程序化调用。
Postman 集合
直接导入 Postman 或 Insomnia 进行交互式测试。
官方 SDK
TypeScript、Python 和 Go 的类型化客户端。MIT 许可,源码托管在 GitHub。
更新日志
每一次 API 变更均标注日期与版本号。遵循 SemVer;破坏性变更会以新的主版本前缀发布。
内部 API
服务间管理与账单接口。仅为完整性而记录,不用于客户集成。
认证
QR Pro API 使用 bearer token 认证:
- API 密钥 · 按产品限定范围,前缀为
abnd_qrpro_,在 abundera.ai/account/api-keys 管理。适用于 Business、Team 和 Agency 套餐(Solo 仅限控制台使用)。 - 原始
abnd_qrpro_…token 仅在创建时显示一次,请立即妥善保存。我们只保留其 SHA-256 哈希;丢失的密钥无法找回。
Authorization: Bearer abnd_qrpro_…
基础 URL 与格式
基础 URL: https://pro.qr.abundera.ai/api
请求格式: JSON(Content-Type: application/json),适用于 POST / PATCH / DELETE。
响应格式: JSON(application/json; charset=utf-8)。
速率限制: 按 API 密钥计算,通过 X-RateLimit-Limit / -Remaining / -Reset 响应头体现。Business / Team / Agency 每 UTC 日分别为 1k/10k/50k 次请求。重定向热路径(aqr.net/{shortcode})无需认证,也没有单次扫描预算限制。
快速示例
curl -X POST https://pro.qr.abundera.ai/api/v1/codes \
-H "Authorization: Bearer abnd_qrpro_…" \
-H "Content-Type: application/json" \
-d '{"name":"Spring menu","destination":"https://example.com/menu","payload_type":"url"}'发现机制(well-known)
/.well-known/ 下的自动发现端点(RFC 8615):
/.well-known/ 索引 →
本站发布的所有 well-known URI 的可读列表。
能力清单
作用域、限速档位、API 覆盖范围。由中枢的联合式界面聚合。
家族 API 目录 →
中枢上的 RFC 9727 Linkset,列出 Abundera 的每一个 API。