本文へスキップ

レート制限

全体的なリクエスト制限​

APIのレートは60秒ごとに150リクエストに制限されている。すべてのリクエストは合計にカウントされます。APIによって処理されるすべてのリクエストは、HTTPヘッダーにレート制限情報を返します。

注意：レート制限はユーザー名とIPアドレスの両方に基づいています。従って、1つのユーザー名は1つのIPアドレスと同様に60秒毎に150リクエストに制限されます。

ログイン要求の制限​

ログインリクエストは、60秒ごとに10リクエストに制限されています。すべてのリクエストは合計にカウントされます。

注意：注意：統計リクエストのIPとユーザー名は、これらの制限にカウントされます。

統計リクエスト制限​

統計リクエストのレートは、各IPアドレスに対して毎分30リクエスト、各ユーザー名に対して毎分25リクエストに制限されています。

注意：注意：統計リクエストのIPとユーザー名は、これらの制限にカウントされます。

例えば、1台のコンピューターで自分のユーザー名でログインし、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 Too Many Requests 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
    }