Support

Find answers, guides, and tutorials to supercharge your content delivery.

Byte-Range Requests

Updated on October 4, 2018
Byte-Range Requests

What are byte-range requests?

Byte-range requests occur when a client asks the server for only a portion of the requested file. The purpose of this is essentially to conserve bandwidth usage by avoiding the need to download a complete file when all that is required is a small section. In order to initiate a byte range request the client will use the range request header to specify what byte range it is requesting (e.g Range: bytes=0-499). Additionally, the server must contain the Accept-Ranges header in its response (e.g Accept-Ranges: bytes).

There are two possible status codes that can occur when a client makes a byte-range request:

  • 206 Partial Content indicates that the request byte range was successfully sent.
  • 416 Requested Range Not Satisfiable indicates that the range was invalid.

What are byte-range requests Used For?

Byte-range requests are used primarily for requesting particular sections of large media files. As mentioned above, they are used largely to conserve bandwidth and save time. Byte-range requests can also be used by multihomed clients (computers with multiple IP addresses connected to one network) to download a file over more than one connection at the same time.

For example, let's say a client only needs a small section of a large media file. Rather than downloading the complete file, the client can use a byte range request and download only the required portion. This can also come in useful for an large download that has been interrupted. Through using a byte-range request, you have the ability to pick up the download at the point when it was interrupted. Another use-case may be that a client wants to download only one important page of a PDF document instead of the document in its entirety.

Examples

An example request that a client may make for a byte range would resemble the following for the first 500 bytes:

Range: bytes=0-499

While the next 500 bytes would look like:

Range: bytes=500-999

Using the example above, the 500 value is known as the first-byte-pos and the 999 value is the last-byte-pos. The last-byte-pos cannot be less than the first-byte-pos otherwise the server will return a 416 error. In the case that the last-byte-pos is not included or is larger than the file in question, the server interprets that the client wants all the data from the first-byte-pos onward.

There are also other byte request variations that can be used such as:

  • A request for the last 500 bytes: bytes=-500
  • A request for the first and last byte: bytes=0-0,-1

Summary

For purposes of saving bandwidth and time, using byte-range requests can be an efficient method of quickly retrieving the information you want and nothing more. This feature becomes increasingly important as the size of the requested file increases, thus using more resources to fully download.

For more information about range requests, visit the IETF range request specification document.

Supercharge your content delivery 🚀

Try KeyCDN with a free 14 day trial, no credit card required.

Get started
KeyCDN uses cookies to make its website easier to use. Learn more