开发文档 > 应用开发 > 开放 API > 使用说明 > 访问频率限制
开放 API
使用说明 获取授权 全部 API 特殊 API 开放功能

访问频率限制

友好速搭使用 Leaky Bucket(漏桶算法),来限制应用对 API(https://api.youhaosuda.com/) 的访问频率,防止滥用 API,影响基础设施的稳定。

桶的容量是 40,漏出速率,是 2 个每秒。只要桶内有剩余空间,那么请求会被立即处理,当桶中没有剩余空间时,API 会返回错误码:429 - 请求过于频繁

API 的访问频率限制,是针对单个 access token,一个应用,安装到不同的站点,获取到的 access token 不同。

如何避免429错误

可以通过检测响应头中的X-YHSD-SHOP-API-CALL-LIMIT,来查看已使用的请求容量:

X-YHSD-SHOP-API-CALL-LIMIT: 35/40

X-YHSD-SHOP-API-CALL-LIMIT的值,包含两部分:实际使用的容量和桶容量。

其中,实际使用容量,会以每秒 2 个的速率减少。比如,当值为 35/40 时,暂停 10 秒对API的访问,那值会变为 15/40。

建议使用以下两种方式,来避免触发 429 错误:

  1. 以固定频率访问 API
    可以设置固定的频率,去使用 API,当频率为 2 个请求每秒时,那永远不会触发 429 错误。
  2. 动态调整访问 API 的频率
    在每次请求 API 后,都检测X-YHSD-SHOP-API-CALL-LIMIT,当使用容量过大时,就降低频率,以确保使用容量,在 40 以内。
品牌电商 从此开始
立即免费使用
电脑访问 youhaosuda.com 免费使用友好速搭
同时拥有电脑+手机端电商网站
<
'

品牌电商 从此开始

+我已经认真阅读并同意友好速搭 服务条款
立即免费使用
已有账号?请登录取消