From c3608f61d9131e22f0227d89e785858bf0bdd952 Mon Sep 17 00:00:00 2001 From: Brian Warner Date: Tue, 28 Jul 2015 13:15:50 -0700 Subject: [PATCH] webapi.rst: document Range: header on GET requests closes ticket#2460 --- docs/frontends/webapi.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/frontends/webapi.rst b/docs/frontends/webapi.rst index 0968f39b..c3dcea6c 100644 --- a/docs/frontends/webapi.rst +++ b/docs/frontends/webapi.rst @@ -348,7 +348,10 @@ Reading a File ``GET /uri/$DIRCAP/[SUBDIRS../]FILENAME`` This will retrieve the contents of the given file. The HTTP response body - will contain the sequence of bytes that make up the file. + will contain the sequence of bytes that make up the file. The "Range:" + header can be used to restrict which portions of the file are returned (see + RFC 2616 section 14.35.1 "Byte Ranges"), however Tahoe only supports a + single "bytes" range and never provides a `multipart/byteranges` response. To view files in a web browser, you may want more control over the Content-Type and Content-Disposition headers. Please see the next section -- 2.37.2