速率限制
总申请限额
API 的速率限制为每 60 秒 150 次请求。所有请求均计入总数。API 处理的每个请求都会在 HTTP 标头中返回速率限制信息。
注意:速率限制基于用户名和 IP 地址。因此,单个用户名每 60 秒只能发出 150 个请求,单个 IP 地址也是如此。
统计请求限制
统计请求的速率限制为:每个 IP 地址每分钟 30 次请求,每个用户名每分钟 25 次请求。
注意:每次统计请求的 IP 和用户名都将计入这些限制。
例如,如果您在一台计算机上用您的用户名登录,并发出 25 个统计请求,那么您的下一个请求就会失败。不过,你可以换一个用户名,在达到 IP 地址限制之前再进行 5 次统计请求。
实例
费率限制 - 例 1
$ curl -i https://api.example.com/v2/statistics/a/date
{
"HTTP/1.1": "200 OK",
"Date": "Fri, 24 Oct 2014 14:57:32 GMT",
"Content-Type": "application/json",
"Transfer-Encoding": "chunked",
"X-Rate-Limit-Limit": 25,
"X-Rate-Limit-Remaining": 44,
"X-Rate-Limit-Reset": 27
}
当超过速率限制时,任何后续请求都会出现 429 请求过多 HTTP 错误,直到速率限制被重置。与正常请求一样,HTTP 标头中也会提供速率限制信息。
速率限制 - 例 2(超出限制)
$ curl -i https://api.example.com/v2/statistics/a/date
{
"HTTP/1.1": "429 Too Many Requests",
"Date": "Fri, 24 Oct 2014 15:04:35 GMT",
"Content-Type": "application/json",
"Transfer-Encoding": "chunked",
"X-Rate-Limit-Limit": 25,
"X-Rate-Limit-Remaining": 0,
"X-Rate-Limit-Reset": 12
}