跳转到主要内容
GetQR API 目前处于 Beta 阶段,仅向部分工作区开放。正式发布前,细节可能会有所变化。
GetQR API 会限制每个 API 密钥可以发送的请求数,以免单个集成拖慢所有人的 API 访问速度。

限制

该限制按一分钟的滑动窗口计算,并对所有端点合并生效。健康检查无需密钥,也不计入限制。

速率限制响应头

使用有效 API 密钥的请求,其响应(包括错误响应)都会带有以下响应头:

超出限制时

超出限制后,API 会返回 429,附带 rate_limit_exceeded 代码和相同的响应头:
请等到重置时间后再发送更多请求。加入随机抖动,避免多个工作进程在同一时刻重试;对于 5xx 错误,请使用指数退避:
重试 POST /api/v1/qrs 时,请务必带上 Idempotency-Key 请求头。这样重试就不会创建第二个二维码。请参阅幂等性。

避免超出限制

  • 关注 X-RateLimit-Remaining,在它降到 0 之前放慢请求速度。
  • 使用批量创建二维码,而不是为每个二维码单独发送一个请求。
  • 使用 pageSize=100 每页获取最多 100 条结果。请参阅分页。
  • 缓存二维码图片:下载接口会返回 ETag,您可以发送 If-None-Match,在内容未变化时获得 304 Not Modified。

后续步骤

错误

二维码