访问频率限制 - 友好速搭 -- 开发文档

友好速搭

开发文档 > 应用开发 > 开放 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 以内。
友好速搭与你一起,共赢未来
联系客服
电话咨询
服务热线
0755-83051027
获取报价
QQ咨询
微信咨询
微信二维码
在线咨询

在线获取方案和报价,专人快速响应

所选城市 *

您的称呼 *

联系电话 *

网站类型 *

请选择
展示官网 电商网站 微信商城 小程序 其他类型

您希望我们为您提供哪些服务?(可多选)

B2C商城 跨境解决方案 B2B2C平台电商 网站备案 自营电商培训
获取报价

提交成功

你好, XXX女士/先生 ,你的需求已提交成功,后续会有专门的客户经理与你电话联系。谢谢!