Skip to content

限流与配额 ​

限流按单个接口独立配置,不同接口的阈值可能不一样。

当前配置概况 ​

项目当前值
接口总数76
开启接口级限流1 个
需要扣费的接口0 个(当前全部免费)
开启个人限流0 个

也就是说,目前绝大多数接口没有单独设置频率阈值,但这不代表可以无限并发——站点还有整体请求频率保护,异常高频同样会返回 429。

触发限流会怎样 ​

超过阈值时接口返回 429,message 通常是「请求过于频繁」,并可能伴随一小段时间的封禁。这段时间内的请求会继续失败,不要立刻用死循环重试。

js
async function callWithRetry(url, max = 3) {
  for (let i = 0; i < max; i++) {
    const res = await fetch(url).then(r => r.json())
    if (res.code !== 429) return res
    await new Promise(r => setTimeout(r, 1000 * Math.pow(2, i)))
  }
  throw new Error('频率仍然过高,请稍后再试')
}

建议:用指数退避、缓存不会变的结果、定时任务错开整点。

费用与余额 ​

每个接口有独立的「单次调用费用」字段,当前全站均为 0。402 账号余额不足 是框架保留码,正常调用不会触发。

缓存与数据新鲜度 ​

不少接口依赖第三方数据源,服务端会做一层缓存,上游异常时还可能回退到最近一次缓存结果:

  • 必应每日一图、福彩开奖查询:约 30 分钟缓存。
  • 贵金属价格:约 10 分钟缓存。

对实时性要求高的场景,请自行判断 timestamp 或数据里的时间字段。

接口数据实时读取自站点数据库