Skip to content
This repository was archived by the owner on Feb 11, 2025. It is now read-only.

Commit d8839f6

Browse files
authored
spec: Require clients follow redirects from parcel GETs
This gives hosts flexibility in serving parcels from alternative services (CDN, IPFS, S3, etc).
1 parent ec15135 commit d8839f6

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

docs/protocol-spec.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ HTTP Endpoints:
1212
- `/_i`
1313
- `POST`: Create a new bindle. If all of the parcels specified in the bindle exist, a 201 status will be returned. If 1 or more of the parcels are missing, a 202 status will be returned with a reference to the missing parcels
1414
- `/_i/{bindle-name}@{parcel-id}`: The path to a Bindle name and parcel ID, where `{parcel-id}` is an exact SHA of a parcel and `{bindle-name}` follows the same rules as outlined above. Parcels can only be accessed if the client has the proper permissions to access the given bindle and, as such, cannot be accessed directly
15-
- `GET`: Directly fetch a parcel's opaque data.
15+
- `GET`: Directly fetch a parcel's opaque data. Clients must follow HTTP redirects from this endpoint.
1616
- `HEAD`: Send just the headers of a GET request
1717
- `POST`: Create a parcel if it does not already exist. This may be disallowed. The data included in the body must have the same SHA as indicated by the `{parcel-id}` and must exist within the invoice
1818
- `/_q`: The query endpoint
@@ -275,4 +275,4 @@ See the [Invoice Specification](invoice-spec.md) for a description of the `[bind
275275

276276
### Ordering of Results
277277

278-
The specification does not provide any guidance on ordering of search results. It is a desirable, but not required, property of search results that under the same circumstances, two identical queries return identical results, including identical ordering.
278+
The specification does not provide any guidance on ordering of search results. It is a desirable, but not required, property of search results that under the same circumstances, two identical queries return identical results, including identical ordering.

0 commit comments

Comments
 (0)