レート制限 & クレジット

上限の対象

プランは 4 つの上限を設けており、いずれも GET /v1/account で確認できます。監視対象数、キーワード数、同時 WebSocket 接続数、毎分のリクエスト数です。最初の 2 つは details.resource 付きの 402 plan_limit を返し、3 つ目はソケットを 4002 で閉じ、4 つ目は Retry-After ヘッダー付きの 429 rate_limited を返します。

ヘッダー

認証済みのすべてのレスポンスが現在の使用状況を伝えるので、クライアントは拒否される前にバックオフできます:

ヘッダー意味
X-RateLimit-Limitこのキーで 1 分間に許可されるリクエスト数
X-RateLimit-Remaining現在の 1 分間に残っている数
X-RateLimit-Resetウィンドウがリセットされる Unix 時刻
X-Credits-Used-TodayUTC 00:00 以降にオンデマンド読み取りで消費したクレジット
X-Request-Idこれを添えてもらえれば、当社のログから該当リクエストを特定できます
X-Response-Time処理にかかった時間 (ミリ秒)
ETagJSON レスポンスの弱いバリデーター。If-None-Match として送り返します
Idempotent-Replay同じ Idempotency-Key を持つ以前のリクエストのリプレイである場合に true
Retry-After待つべき秒数。すべての 429 に付きます
Location201 と 202 で、作成またはキューに入ったリソースの場所

クレジット

ストリーミングは従量課金ではありません。アイドル状態の接続も忙しい接続もコストは同じで、ソケット上のフレームはリクエスト枠を消費しません。読み取りにあるオンデマンドの REST 読み取りはクレジットを消費し、エンドポイントごとに記載のとおり 1 回につき 1〜2 クレジットです。GET /v1/account/usage で日次合計を確認できます。