コンテンツへスキップ

ecentic API レート制限。

すべての公開レスポンスには現在のウィンドウ状態が含まれるため、エージェントは拒否されて制限を知るのではなく、自律的にペース調整できます。

現在値ヘッダー · 429時のRetry-After · キー単位のウィンドウ

01

ポリシー

公開インターフェースでは、1つの固定ウィンドウで認証情報ごとに回数をカウントします。

public

すべての /api/v1 エンドポイント

120リクエスト

60秒ごと

news

/api/v1/news

30リクエスト

60秒ごと

news-resolve

/api/v1/news?resolve=true

6リクエスト

60秒ごと

bearerキー付きのリクエストはそのキー単位でカウントされ、それ以外はクライアントIP単位でカウントされます。これにより、過剰なアクセスを行う1つのエージェントが共有アドレス全体の上限を消費することを防ぎます。

ウィンドウはスライディング方式ではなく固定方式です。壁時計ベースの境界でリセットされ、ヘッダー内のreset値はその境界までの残り秒数を示します。

APIで適用されるポリシー
02

ヘッダー

両方の表記を送信します。クライアント側で既に対応している方を利用してください。

RateLimit-Policyは常に送信されます。これは、特定のリクエストがカウント可能かどうかに関係なく、ポリシー自体は有効だからです。現在値カウンターは、実際に測定された値が存在する場合にのみ送信されます。カウンターへ到達できない環境では、未測定の上限を示す代わりに省略されます。

意味を確認するにはヘッダーを選択してください。これらの値はレスポンス例であり、リアルタイムのカウンターではありません。

ヘッダー例

意味: 現在のポリシー。クォータとウィンドウ長(秒)。

1つの制限枠、2つの表現

この例では、両方のヘッダー形式が同じ制限枠を示しています。

残りリクエスト数
118
r=118 · RateLimit-Remaining
リセットまでの秒数
42
t=42 · RateLimit-Reset
03

制限を超えた場合

429も他の失敗と同じ型付きproblemドキュメントです。

レスポンスはapplication/problem+json形式で、コードはrate-limitedです。また、レート制限ヘッダーとともにRetry-Afterを返します。即座に再試行するのではなく、指定された秒数だけ待機してください。同じウィンドウ内で再試行すると、そのリクエストもカウントされ、再び拒否されます。

例: 429レスポンス