主题
限流与配额
限流按单个接口独立配置,不同接口的阈值可能不一样。
当前配置概况
| 项目 | 当前值 |
|---|---|
| 接口总数 | 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 或数据里的时间字段。