HTTP Rangeヘッダー計算

部分ダウンロード、動画シーク、中断後の再開はいずれもHTTP Rangeリクエストヘッダーに依存します。このHTTP Rangeヘッダー計算ツールは、解析用のRange値、または構築用の開始・終了・サフィックス各フィールドを受け取り、長さ付きの構造化範囲、リソースサイズに対する充足可否、206または416のstatus_hint、単一の充足可能範囲が分かる場合のContent-Range文字列を返します。ヘッダー確認だけのために完全なHTTPスタックを立てず、決定的なバイト演算が必要なときにご利用ください。

HTTP Rangeヘッダーの意味と本ツールが受け付ける形式

HTTP Rangeリクエストは、クライアントが表現全体ではなくどのバイト区間を欲しいかをサーバーに伝えます。閉じた範囲 開始-終了 は両端を含み、bytes=0-499 は先頭の五百バイトを要求します。resource_sizeを指定すると、各指定は絶対的な開始・終了オフセットに解決されます。解決されたすべての範囲が充足可能でリソースが空でないとき、status_hintは206 Partial Contentです。

入力契約、buildとparse、応答フィールド

modeをparseまたはbuildに設定してください。parseモードではrange_headerが必須で、bytes=0-499、Range: bytes=500-、マルチパート bytes=0-0,-1 のような形を取り得ます。buildモードでは末尾N形式のsuffix_length、または閉じた／開いた形式のためのstartと任意の包括的endを指定し、suffix_lengthをstartやendと混在させないでください。resource_sizeは両モードで任意です。構文正規化と閉じた範囲の長さだけなら省略し、satisfiableフラグ、実ファイルに対するbytes_requested、content_range、status_hintが必要なら含めてください。整数は非負の安全な整数で、suffix_lengthは少なくとも1である必要があります。成功時の本体には常にmode、正規化されたrange_header、unit bytes、range_count、ranges配列が含まれます。各範囲オブジェクトはkind（closed、open_end、suffix）、raw文字列、既知の場合はstart、end、length、suffix、satisfiableを持ちます。トップレベルのbytes_requestedは、すべての長さが既知のときの解決済み長さの合計です。content_rangeは単一の充足可能範囲についてbytes 開始-終了 スラッシュ サイズとして、充足不可のときはbytes アスタリスク スラッシュ サイズとして出力されます。無効なヘッダー、不正なmode、矛盾するフィールド組み合わせはinvalid_inputで失敗し課金されません。例: resource_sizeが一万のときbytes=0-499を解析すると長さ五百、content_range bytes 0-499/10000、status_hint 206となります。

HTTP Range計算機が真価を発揮する場面

ダウンロードマネージャーやインストーラはネットワーク切断後にRangeヘッダーを再送して大きな成果物を再開します。共有の計算機は、ISO全体を再取得したりPDFの重要ページを飛ばしたりするオフバイワンを防ぎます。プログレッシブMP4や音声をシークするメディアプレーヤーは開いた／閉じた範囲を組み立て、スクラバーを描く前にオリジンが206か416かを知る必要があります。APIゲートウェイとCDN設定のテストは、既知のオブジェクトサイズに対してエッジ規則が範囲を正しく転送・クランプすることを、フルオリジンを起動せずに検証します。SDK作者は同じ純粋関数を単体テストに埋め込み、言語をまたいでクライアントとサーバーのフィクスチャを揃えます。実装は純粋parseのティアAのため、成功した呼び出しはすべて公開の基本料金$0.002で、モデルトークンも外向きネットワークもありません。resource_sizeを正直に保ち、構造化範囲をテストに固定すれば、バイトを数えるためだけに完全なスタックを届けなくても、エッジワーカー、CLI、教室のHTTP実験向けに再現可能な再開演算が得られます。