跳至主要内容

速率限制

总申请限额​

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
    }