每分钟 45 次的限流与两类报错

接口免费无限量？不是。官方文档写死了两条红线，写工具前必须知道。

限流：每分钟 45 次

超过即触发 429 - Too many requests。45 次/分钟对人工使用绰绰有余，对程序来说很容易撞线——一个「每 3 秒翻一页」的轮换工具贴着限额跑没问题，「每秒翻 10 页」必然被掐。

节流的通用做法：请求间隔不低于 1.5~2 秒；收到 429 就指数退避（等 30 秒、再 60 秒），不要立即重试火上浇油。

401 的两种触发

也就是说 401 有两种含义：一是「你没资格看这个」（补密钥或改 purity 参数），二是「你的密钥本身坏了」（去账号设置重新生成）。排查时先区分是哪种。

密钥的两种传法

1. 查询串：URL 后接 ?apikey=密钥——简单直接，但 URL 会进日志，共享链接时注意。
2. 请求头：加 X-API-Key: 密钥——工具开发推荐，密钥不落在 URL 里。

接口变更的免责说明

官方文档原文值得转述：API 免费按「现状」提供，无保修；尽管会尽量提前通知变更，不排除临时调整。所以工具里对非 200 响应要有兜底逻辑，别把接口当 SLA 服务依赖。

接下来去哪

• 密钥的生成与重置：看 在账号设置里生成与重置 API 密钥。
• 爬虫与接口的边界：看 批量下载与脚本采集的官方态度。