HTTPQUERY
日本語

Accept-Ranges

使い方

Accept-Ranges ヘッダーは、サーバーが範囲リクエストを受け付けることをクライアントに伝え、リソースの部分ダウンロードを可能にします。これは中断されたファイル転送の再開、特定位置からのメディアストリーミング、巨大ファイルの一部を必要に応じて取得する用途に欠かせません。

クライアントが範囲リクエストを送信すると、サーバーは要求されたバイト区間だけを含む 206 Partial Content レスポンスを返します。Content-Range レスポンスヘッダーが、正確なバイト範囲とリソースの総サイズを示します。

要求された範囲が不正であるか、リソースの境界を外れている場合、サーバーは 416 Range Not Satisfiable で応答します。

bytes

サーバーがバイト範囲リクエストを受け付けることを示します。これは HTTP が定義する唯一の範囲単位であり、このヘッダーで最も一般的な値です。

none

サーバーがこのリソースに対する範囲リクエストをサポートしないことを示します。none を明示的に送ることで、範囲リクエストを試みないようクライアントに伝えます。

例

バイト範囲リクエストのサポートを示すサーバーです。ダウンロードマネージャーやメディアプレーヤーはこのシグナルを使ってファイルの特定部分を要求します。

Accept-Ranges: bytes

範囲リクエストを明示的に無効化したサーバーです。この値を受け取ったクライアントは、1 回のリクエストでリソース全体をダウンロードします。

Accept-Ranges: none

ダウンロード可能なファイルに対する典型的なレスポンスで、範囲サポートの表示とコンテンツ長を組み合わせています。5000 バイト目で中断したクライアントは、失敗した地点から再開できます。

HTTP/1.1 200 OK
Accept-Ranges: bytes
Content-Length: 1048576
Content-Type: application/octet-stream