ToRouterドキュメントAPI キー
クォータ、レートリミット、有効期限
キーごとに USD 利用上限、ウィンドウ単位のリクエスト制限、N 日後の自動失効を設定します。
ToRouter のキーには 3 種類の独立したガードがあります。アカウント側の プランに付随する上限 と組み合わされ、より厳しい側が先に適用されます。
利用上限（USD）
キーが消費してよい USD の天井です。
- キー単体の上限を設けない — 既定のまま、または 0 にすると、プラン側の枠に従い、キー専用の天井は設けません。
- 正の値 — 累計利用額がこの値に達すると、以降のリクエストは拒否されます。
使い切ると 402 が返ります。チャージするか、ポータルで上限を調整してください。
リクエスト頻度（スライディングウィンドウ）
3 つの独立したウィンドウでリクエスト数を数えます。有効なウィンドウすべて に余裕があるときだけ通過します。
- おおよそ 5 時間 — 短時間のバーストを抑えます。
- おおよそ 24 時間 — 日次のペース配分向け。
- おおよそ 7 日間 — 共有キーの週次バジェット向け。
ウィンドウごとに 0 を入れると、そのウィンドウはオフになります。いずれかに抵触すると 429 です — レートリミット超過 を参照。
自動失効
作成から N 日後にキーを自動的に無効化できます。
- 0 — 無期限（既定）。
- 30 — おおよそ 30 日後に失効。
期限切れのキーは 401 を返します。継続利用には新しいキーを作成してください（ローテーション）。
制限は上流呼び出しの 前 に評価されるため、ブロックされたリクエストには課金されません。
制限の編集
API Keys → 対象のキーをクリック → Edit → 保存。変更は次のリクエストから有効になります。