仕様書

[1] RFC 7233 - Hypertext Transfer Protocol (HTTP/1.1): Range Requests (2014-09-11 09:57:55 +09:00 版) https://tools.ietf.org/html/rfc7233#section-2
[16] RFC 7233 - Hypertext Transfer Protocol (HTTP/1.1): Range Requests (2014-09-11 09:57:55 +09:00 版) https://tools.ietf.org/html/rfc7233#section-3.1
[14] Hypertext Transfer Protocol (HTTP) Parameters (2014-06-13 18:52:05 +09:00 版) http://www.iana.org/assignments/http-parameters/http-parameters.xhtml#range-units
[2] RFC 2326 - Real Time Streaming Protocol (RTSP) (2014-07-13 07:26:48 +09:00 版) http://tools.ietf.org/html/rfc2326#section-12.29

構文

[8] 範囲単位は構文的には字句とされています >>1。

字句

[9] HTTP と RTSP で定義されている範囲単位はすべてASCII大文字・小文字不区別となっています >>1, >>2。明記されていませんが、すべての範囲単位は ASCII大文字・小文字不区別と思われます。

文脈

[4] 範囲単位は、次の場面で使われます。

Accept-Ranges:
Range:
Content-Range:

単位

[6] 次の範囲単位が存在しています。

bytes
rows
items
xpointer
smpte
smpte-30-drop
smpte-25
npt
clock
id
name
email
hostname
number
fingerprint
type
url
started_at
updated_at
version
none

[15] HTTP については IANA登録簿があります >>14。 RFC 7233 で導入されました。

[5] HTTP では、 bytes が規定されているほか、新しい単位は IANA に登録するべきought to >>1 とされています。

[7] RTSP ではsmpteSMPTE時刻符号、 smpte-30-dropSMPTE時刻符号、 smpte-25SMPTE時刻符号、 npt、clockclock (RTSP) が規定されています。

[12] これらは Protocol for Media Fragments 1.0 Resolution in HTTP で HTTP においても提案されていましたが、謎の接頭辞の仕組みが併用されています。

[10] none は範囲単位ではありませんが、 Accept-Ranges: で範囲単位のかわりに用いられます。 IANA にも予約として登録されています >>14。

[17] HTTP ではどの範囲単位の実装も義務付けられていませんが、鯖とキャッシュは bytes を実装するべきought to >>16 とされています。大容量のファイルの送受信を行う利用者エージェントや鯖は、実用上、 bytes を実装する必要があります。

[20] 未対応の鯖は範囲の指定を無視するでしょうし、未対応の利用者エージェントはファイル全体を要求するだけでしょうから、非効率的であるだけで実装しなくても構わないといえば構わないのですが。

濫用

[19] Heroku API >>18 はページングのためのキーの指定のために範囲単位を濫用しています。

[18] Platform API Reference | Heroku Dev Center (2014-10-08 12:28:43 +09:00 版) https://devcenter.heroku.com/articles/platform-api-reference#ranges

メモ

[11] ajax - Using the HTTP Range Header with a range specifier other than bytes? - Stack Overflow ( (2014-09-17 02:47:06 +09:00 版)) http://stackoverflow.com/questions/1434647/using-the-http-range-header-with-a-range-specifier-other-than-bytes

[13] Byte Rot: Using range header for retrieving range of IEnumerable<T> in ASP.NET Web API ( (2014-09-04 13:25:18 +09:00 版)) http://byterot.blogspot.jp/2012/07/range-header-asp-net-web-api-entity-pagination.html

[21]

Platform API Reference | Heroku Dev Center (2017-02-11 14:47:15 +09:00) https://devcenter.heroku.com/articles/platform-api-reference#ranges

List requests will return a Content-Range header indicating the range of values returned. Large lists may require additional requests to retrieve. If a list response has been truncated you will receive a 206 Partial Content status and the Next-Range header set. To retrieve the next range, repeat the request with the Range header set to the value of the previous request’s Next-Range header.
The number of values returned in a range can be controlled using a max key in the Range header. For example, to get only the first 10 values, set this header: Range: id ..; max=10;. max can also be passed when iterating over Next-Range. The default page size is 200 and maximum page size is 1000.
The property used to sort values in a list response can be changed. The default property is id, as in Range: id ..;. To learn what other properties you can use to sort a list response, inspect the Accept-Ranges headers.

[22]

Divide Large Responses Across Requests with Ranges · HTTP API Design (Wesley Beary著, 2017-02-10 22:07:15 +09:00) https://geemus.gitbooks.io/http-api-design/content/en/foundations/divide-large-responses-across-requests-with-ranges.html

Large responses should be broken across multiple requests using Range headers to specify when more data is available and how to retrieve it.