レート制限

全体のリクエスト制限

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

注意: レート制限はユーザー名とIPアドレスの両方に基づいています。そのため、1つのユーザー名は60秒ごとに150リクエストに制限され、1つのIPアドレスも同様です。

ログインリクエストの制限

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

注意: 実行された各統計リクエストのIPアドレスとユーザー名は、これらの制限にカウントされます。

統計リクエストの制限

統計リクエストは、各IPアドレスごとに1分あたり30リクエスト、各ユーザー名ごとに1分あたり25リクエストにレート制限されています。

注意: 実行された各統計リクエストのIPアドレスとユーザー名は、これらの制限にカウントされます。

たとえば、1台のコンピューターであなたのユーザー名でログインし、統計リクエストを25回送信すると、次の1回は失敗します。ただし、別のユーザー名に切り替えれば、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 リクエストが多すぎます",
  "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
}