レート制限とキャッシュ

送信できるリクエスト数、それを知らせるヘッダー、キャッシュすべきもの。

1分あたり120リクエスト

公開 API には、アドレスごとに 1 分あたり 120 件のリクエストを送れます。カウントは時計の毎分の始まりにリセットされます。それまでの残り秒数は RateLimit-Reset で確認できます。

現在の状況を示すヘッダー

すべてのレスポンスには、時間枠で許可されるリクエスト数を示すRateLimit-Limit、残りの数を示すRateLimit-Remaining、時間枠が再開するまでの秒数を示すRateLimit-Resetが付きます。

HTTP

RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 20

上限を超えたとき

上限を超えたリクエストは429 rate_limitedを返し、秒数を示すRetry-Afterヘッダーが付きます。次のリクエストまでその時間だけ待ってください。その間にさらに送信しても待ち時間は短くなりません。

HTTP

HTTP/1.1 429 Too Many Requests
Retry-After: 37

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Wait and try again."
}

コピーを保存する

カタログのデータが変わるのは多くても1日に数回です。使用するレスポンスを保存し、訪問者ごとに再要求するのではなく、定期的に更新してください。一部のレスポンスには、新しい状態が保たれる期間を示すCache-Controlヘッダーが付きます。