GetQR API 目前处于 Beta 阶段,仅向部分工作区开放。正式发布前,细节可能会有所变化。
限制
该限制按一分钟的滑动窗口计算,并对所有端点合并生效。健康检查无需密钥,也不计入限制。
速率限制响应头
使用有效 API 密钥的请求,其响应(包括错误响应)都会带有以下响应头:超出限制时
超出限制后,API 会返回429,附带 rate_limit_exceeded 代码和相同的响应头:
5xx 错误,请使用指数退避:
避免超出限制
- 关注
X-RateLimit-Remaining,在它降到 0 之前放慢请求速度。 - 使用批量创建二维码,而不是为每个二维码单独发送一个请求。
- 使用
pageSize=100每页获取最多 100 条结果。请参阅分页。 - 缓存二维码图片:下载接口会返回
ETag,您可以发送If-None-Match,在内容未变化时获得304 Not Modified。