快速入门

请求频率限制

每个用户最多可发送每分钟 120 个请求，该用户所有密钥的请求合并计算。计数器在每个整分钟时重置。

使用有效密钥时，响应会通过以下响应头显示用量：

名称	类型	说明
`X-RateLimit-Limit`	`integer`	每分钟允许的请求数。
`X-RateLimit-Remaining`	`integer`	当前这一分钟内剩余的请求数。
`X-RateLimit-Reset`	`integer`	距离计数器重置的秒数。
`Retry-After`	`integer`	仅出现在 `429` 响应中：重试前需要等待的秒数。

超出限制时，响应为 429，错误代码为 rate_limited。请等待 Retry-After 指定的时间后再重试。

未携带有效密钥的请求（未提供密钥、密钥错误或已撤销）按每个 IP 地址每分钟 30 次进行限制。

如何避免达到限制

将 per_page 设置为最多 100，用更少的请求获取更多项目。
如需跟踪电视状态，每分钟查询一次即可。
处理大批量任务时，请将请求分散到不同时间发送，并留意 X-RateLimit-Remaining。

响应头示例200

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42

已达到限制429

HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 18 seconds."
  }
}