QRmkr

二维码 API:用代码创建动态码与读取扫码数据

控制台背后的那几件基础能力,动态码、修改目标、扫码日志,在 Business 方案里同样开放给你自己的软件。

每一个 QRmkr 动态码都建立在两个简单的基础能力上:一条由你控制的永久短跳转,以及一份记录每次访问的扫码日志。Business 方案的 API 权限把这两样能力交到你自己的系统手里,你的软件可以创建动态码、重新指向目标、读取扫码统计,而不需要有人去控制台里点来点去。扫码数据目前可以通过一个需要认证的接口以 CSV 形式获取,文档见下文。

你能得到什么

从你自己的技术栈里创建动态码

Business 方案的 API 权限覆盖动态码的程序化操作:生成一个码,以及更新它那条永久跳转指向哪里,和控制台里做的编辑是同一件事。

读取扫码统计

每次扫码都会记录时间、设备类型、操作系统、浏览器和粗略位置。你可以从一个需要认证的接口把某个码的完整扫码日志取成 CSV,加载进数据仓库或 BI 工具。

简单、标准的认证方式

请求使用账号的会话令牌认证,也就是登录时签发的一个有效期 30 天的 JWT,以 HTTP-only cookie 形式下发。普通的 HTTPS 请求即可,不需要 SDK。

使用步骤

  1. 1

    升级到 Business,其中包含 API 权限,另外还有 5 个团队席位和自定义短链域名。

  2. 2

    完成认证:登录以获取会话令牌(有效期 30 天的 JWT),并在请求中作为 qrm_session cookie 发送。

  3. 3

    拉取数据:从导出接口获取任意一个码的扫码日志 CSV,围绕它把你的流程自动化。

常见问题

QRmkr 的二维码 API 能做什么?

API 权限是 Business 方案的功能,覆盖动态二维码的程序化使用:创建码、更新某个码的目标链接、读取扫码统计。本页记录的扫码数据导出接口今天就是可用的。开通 Business 方案后请联系 support@qrmkr.io,我们会帮你把对接做好。

API 认证是怎么工作的?

使用账号的会话令牌。登录会签发一个有效期 30 天的 JWT,以名为 qrm_session 的 HTTP-only cookie 下发。在你的集成请求里带上这个 cookie。请妥善保管该令牌,它拥有账号的完整权限,并且始终通过 HTTPS 调用 API。

扫码数据导出里包含什么?

每次扫码一行 CSV:时间戳、设备类型、操作系统、浏览器、国家、城市和来源地址。位置是粗略的(国家和城市级别),并且我们保存的是加盐哈希而不是原始 IP 地址。

哪个方案包含 API 权限?

Business 方案,每月 $39(按年付费时相当于每月 $32)。它包含 Pro 的全部内容:不限数量的动态码、目标链接编辑、扫码统计,另外还有最多 5 个团队成员、自定义短链域名、API 权限,以及更高的 AI 艺术二维码额度。

准备把二维码接进你的系统了吗?

API 权限属于 Business 方案,每月 $39,包含 Pro 的全部内容,随时可取消。

查看 Business 价格

继续阅读