API
API(Application Programming Interface)是软件之间交换数据与功能的约定和接口。Web API 通过 HTTP 协议在互联网上收发数据,是现代 Web 服务的基础技术。在二维码的语境里,API 主要承担三件事:二维码的批量生成、动态二维码的管理、扫描数据的获取。
使用二维码生成 API,程序就能自动产出二维码。例如电商网站每当一笔订单成立,就自动生成包含订单编号的二维码,并附在确认邮件中。一天有数千笔订单的电商网站,靠人工逐个生成二维码并不现实,用 API 自动化是必需的。
多数动态二维码管理服务都提供 REST API,可以用程序完成二维码的创建、跳转目标的变更、扫描统计的获取。把自家的 CRM 或库存管理系统与 API 对接后,就能依据客户数据或库存数据,动态控制二维码指向的链接。调用 API 需要用访问令牌认证,并且通常会设置速率限制(每分钟的请求数上限)。
实务上容易被忽略的是错误处理与配额管理。请求超过速率限制时服务器会返回 429 状态码,客户端应当按指数退避的间隔重试,而不是立刻反复叩门。访问令牌不要写进前端代码,应保存在服务器端的环境变量里并定期更换,否则密钥一旦泄露,他人就能以你的名义无限生成二维码。