ForHosting KIT · 開発者向けツール

レート制限ヘッダーを解析してリセット時間を計算

上限100、残り42、リセット値60を12:00 UTCに受け取ったなら、再開は12:01、つまり60秒後です。3つの値と受け取った時刻を貼り付ければ、安全な再試行の時期を決められます。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
上限
100
残り
42
リセット
60
現在時刻
2026-07-25T12:00:00Z
結果
極限
100
残り
42
リセットの種類
seconds_offset
リセット時刻 (Unix時間)
1,784,980,860

レート制限ヘッダーは単純に見えますが、サービスごとにリセット時刻の表現が異なります。Unix秒、Unixミリ秒、厳密なUTCのISO 8601時刻、短い秒数オフセットに対応します。

リセット値の読み取り方

レート制限のヘッダーには通常、上限、残りの回数、枠が戻る時点の3つの値があります。ただし最後の値の書き方はサービスごとに異なります。30や900のような小さな数は、指定した現在時刻に足す秒数として扱います。十億以上はUnix秒、千億以上はUnixミリ秒とみなして秒に換算します。末尾にZの付いたUTCの日時も受け付けます。上限100、残り42、リセット値60で現在が12:00 UTCなら、枠は12:01、つまり60秒後に戻ります。

よくある間違いと結果の使い方

最も高くつく間違いは、読めない値を0として扱うことです。すぐに再試行して制限を悪化させ、障害を長引かせます。このツールでは、読めない値ははっきりエラーになります。負の数、ありえない日付、上限より多い残り回数も受け付けません。待ち時間は秒単位に切り上げるため、最後の一瞬に再試行することはありません。すでに過ぎたリセット時刻なら待ち時間は0です。そのうえで、待つか、作業を列に入れるか、同時実行を減らすか、メッセージを出すかはプログラム側で決めてください。

タイムスタンプとオフセットの判定方法を確認します

数値のresetには一般的な規則を適用します。10億以上はUnix秒、1000億以上はUnixミリ秒として読み取り、後者は秒へ変換します。resetには2026-07-25T12:01:00Zのような厳密なUTCのISO 8601時刻も指定でき、ミリ秒は任意です。

UTC接尾辞によりタイムゾーンの曖昧さを防ぎます。存在しない日付、不正な時刻、欠落、負数、無関係な文字列は検証で検出します。解析不能なresetを暗黙に0へ変換せず入力エラーにするため、誤った即時再試行による制限の悪化を防げます。

再現可能な再試行テストを作成

固定した現在時刻を渡し、システム時計を模擬せずに安定した計算を検証します。

どのリセット形式に対応していますか?

0以上の秒数オフセット、秒またはミリ秒のUnixタイムスタンプ、末尾がZの厳密なUTCのISO 8601時刻に対応します。

このツールは要求を送ったり、リセットまで待ったりしますか?

いいえ。どこにも要求を送らず、待機もしません。すでに取り出した3つの値と現在時刻から計算するだけなので、待つか後で処理するかはプログラム側で決めます。

リセット時刻がすでに過ぎている場合はどうなりますか?

待ち時間は0になり、負の値にはなりません。保存済みの記録や遅れて届いた通知を見直すときに、余計な待ち時間を作らず、すぐ再試行できると分かります。

なぜ現在時刻を入力する必要があるのですか?

システムの時計で答えが変わらないようにするためで、同じ入力なら常に同じ結果になります。応答を受け取った時刻を、Unix秒、Unixミリ秒、UTCの日時のいずれかで入力します。この値が経過秒数として扱われることはありません。

残り回数が上限より多いとどうなりますか?

受け付けられません。上限と残り回数は0以上の整数で、残りが上限を超えてはいけません。読めないリセット値も0ではなくエラーとして返し、すぐに再試行してしまうのを防ぎます。

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

POSThttps://api.kit.forhosting.com/security/rate-limit-header-parse

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

curl -X POST https://api.kit.forhosting.com/security/rate-limit-header-parse \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"100","remaining":"42","reset":"60","current_time":"2026-07-25T12:00:00Z"}'
{
  "limit": "100",
  "remaining": "42",
  "reset": "60",
  "current_time": "2026-07-25T12:00:00Z"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "security.rate_limit_header_parse",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_limitedリクエストが多すぎます。しばらく待ってから再度お試しください。

この解析ツールは、上限、残数、リセット値、明示的な現在時刻を受け取り、正規化した数値とリクエストが再び可能になるまでの秒数を返します。現在時刻を指定するため、同じ入力からはテスト、ブラウザー、APIのどこでも常に同じ結果が得られます。

再試行を予約する前にヘッダーを正規化します

元のreset文字列を保持し、絶対タイムスタンプと秒数オフセットのどちらとして解釈したかを示し、正規化したUnix時刻を返します。リセット時刻が過去なら、負数ではなく0を返します。結果はログ、再試行ミドルウェア、キューの遅延、テスト用データにそのまま利用でき、統合ごとに同じ規則を実装する必要がありません。APIは通常、最大リクエスト数、残数、リセット値を返しますが、クライアントはそれらの文字列を安全な再試行判断へ変換する必要があります。各値をlimit、remaining、resetとして渡し、レスポンスを受信した時刻をcurrent_timeに指定してください。解析ツールはlimitとremainingが0以上の整数であることを確認し、残数が上限を超える入力を拒否します。seconds_until_resetは秒単位で切り上げるため、待機時間の最後の端数で早すぎる再試行を行いません。

タイムスタンプとオフセットの判定方法を確認します

それより小さい0以上の数値はcurrent_timeに加える秒数オフセットです。そのため、30や900は待機時間となり、現在のエポック時刻は絶対値のまま扱われます。current_timeも同じ絶対時刻形式に対応しますが、オフセットとしては扱いません。

クライアントとテストで再現可能な結果を利用します

再試行ポリシーでは、値の解析と動作の判断を分けることが重要です。この機能でクォータ情報を確定し、待機、キューへの再登録、同時実行数の削減、メッセージ表示はお客様のアプリケーションで決定してください。正午を現在時刻として60を指定すれば、常に1分後のタイムスタンプと残り60秒が得られます。抽出済みの標準値のみを処理します。current_timeを明示するため、システム時計、ネットワーク、ロケール、乱数によって答えが変わりません。指定時刻より前のリセットは0となり、遅延したWebhookや保存済みログの処理にも便利です。このツールはベンダー固有のヘッダーを推測せず、指数バックオフも選択しません。ブラウザー版は無料で、自動API呼び出しは1項目あたり$0.002です。

安全なAPI再試行を予約

ヘッダー文字列を整数秒の遅延へ変換してから、失敗した処理をキューへ戻します。

提供元のスロットリングを調査

取得したヘッダーを正規化し、リセット時刻とレスポンス受信時刻を比較します。

API呼び出しの料金はいくらですか?

1項目には$0.002の基本料金が適用されます。ブラウザーツールでは同じ計算をローカルで実行できます。

current_timeを指定する理由は何ですか?

現在時刻を明示すると計算が決定論的になり、クライアントやテストで同じ結果を再現できます。

リセット時刻が過ぎている場合はどうなりますか?

seconds_until_resetは0になり、reset_at_unixには解析した絶対時刻が保持されます。

このツールはリクエストや待機を実行しますか?

いいえ。値の検証と正規化だけを行い、再試行やバックオフの判断はお客様のアプリケーションに委ねます。

KITの完全なドキュメントを見る →