Skip to content

Commit 0dbbea6

Browse files
authored
Merge pull request #430 from ipfs/should-range-single
path-gateway: clarify Range should support single range
2 parents 76d7b66 + a30af20 commit 0dbbea6

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed

src/http-gateways/path-gateway.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ editors:
2222
xref:
2323
- url
2424
- trustless-gateway
25+
- ipip-0402
26+
- ipip-0412
2527
tags: ['httpGateways', 'lowLevelHttpGateways']
2628
order: 0
2729
---
@@ -143,15 +145,22 @@ For example:
143145

144146
### `Range` (request header)
145147

146-
`Range` can be used for requesting specific byte ranges of UnixFS files and raw
148+
`Range` can be used for requesting specific byte range of UnixFS files and raw
147149
blocks.
148150

149151
Gateway implementations SHOULD be smart enough to require only the minimal DAG subset
150152
necessary for handling the range request.
151153

152-
NOTE: for more advanced use cases such as partial DAG/CAR streaming, or
153-
non-UnixFS data structures, see the `selector` query parameter
154-
[proposal](https://github.com/ipfs/go-ipfs/issues/8769).
154+
Gateways SHOULD support single range requests. The support of more than one
155+
range is optional: implementation MAY decide to not support more than one range.
156+
157+
:::note
158+
159+
For more advanced use cases such as partial DAG/CAR streaming, or non-UnixFS
160+
data structures, see `dag-scope` and `entity-bytes` from :cite[ipip-0402] and
161+
ordered CARs from :cite[ipip-0412].
162+
163+
:::
155164

156165
### `Service-Worker` (request header)
157166

0 commit comments

Comments
 (0)