ForHosting KIT · 開発者向けツール

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

レート制限ヘッダーは単純に見えますが、サービスごとにリセット時刻の表現が異なります。この解析ツールは、上限、残数、リセット値、明示的な現在時刻を受け取り、正規化した数値とリクエストが再び可能になるまでの秒数を返します。Unix秒、Unixミリ秒、厳密なUTCのISO 8601時刻、短い秒数オフセットに対応します。現在時刻を指定するため、同じ入力からはテスト、ブラウザー、APIのどこでも常に同じ結果が得られます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

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

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

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

数値のresetには一般的な規則を適用します。10億以上はUnix秒、1000億以上はUnixミリ秒として読み取り、後者は秒へ変換します。それより小さい0以上の数値はcurrent_timeに加える秒数オフセットです。そのため、30や900は待機時間となり、現在のエポック時刻は絶対値のまま扱われます。resetには2026-07-25T12:01:00Zのような厳密なUTCのISO 8601時刻も指定でき、ミリ秒は任意です。UTC接尾辞によりタイムゾーンの曖昧さを防ぎます。current_timeも同じ絶対時刻形式に対応しますが、オフセットとしては扱いません。存在しない日付、不正な時刻、欠落、負数、無関係な文字列は検証で検出します。解析不能なresetを暗黙に0へ変換せず入力エラーにするため、誤った即時再試行による制限の悪化を防げます。

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

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

活用例

安全なAPI再試行を予約

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

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

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

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

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

よくある質問

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

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

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

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

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

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

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

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

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

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

開発者向け — APIアクセス

このページの機能はすべて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"}'

const res = await fetch("https://api.kit.forhosting.com/security/rate-limit-header-parse", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "limit": "100",
    "remaining": "42",
    "reset": "60",
    "current_time": "2026-07-25T12:00:00Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/security/rate-limit-header-parse",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "limit": "100",
    "remaining": "42",
    "reset": "60",
    "current_time": "2026-07-25T12:00:00Z"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/security/rate-limit-header-parse", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"limit":"100","remaining":"42","reset":"60","current_time":"2026-07-25T12:00:00Z"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"limit":"100","remaining":"42","reset":"60","current_time":"2026-07-25T12:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/security/rate-limit-header-parse", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

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

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