mirror of
https://code.rocketnine.space/tslocum/twins.git
synced 2024-11-27 13:48:13 +01:00
44 lines
1.2 KiB
Markdown
44 lines
1.2 KiB
Markdown
This page is also available at [gemini://twins.rocketnine.space/proposals.gmi](gemini://twins.rocketnine.space/proposals.gmi)
|
|
|
|
The following proposals add fields to the response header of successful
|
|
requests.
|
|
|
|
Standard successful response header (for comparison):
|
|
|
|
```
|
|
20 text/gemini; charset=utf-8
|
|
```
|
|
|
|
These additions are backwards-compatible as specified in [RFC 2045](https://tools.ietf.org/html/rfc2045):
|
|
|
|
> MIME implementations must ignore any parameters whose names they do not recognize.
|
|
|
|
The terms MAY, SHOULD and SHOULD NOT are defined in [RFC 2119](https://tools.ietf.org/html/rfc2119).
|
|
|
|
# Cache
|
|
|
|
Gemini servers MAY include a duration (in seconds) which a client SHOULD cache
|
|
a resource when the request is successful. When a cache duration of 0 or
|
|
less is provided, clients SHOULD NOT cache the resource.
|
|
|
|
Cache for one week:
|
|
|
|
```
|
|
20 text/gemini; charset=utf-8; cache=604800
|
|
```
|
|
|
|
Do not cache:
|
|
|
|
```
|
|
20 text/gemini; charset=utf-8; cache=0
|
|
```
|
|
|
|
# Size
|
|
|
|
Gemini servers SHOULD include the size (in bytes) of the response body when the
|
|
request is successful. Clients SHOULD utilize this information when downloading
|
|
files to indicate progress.
|
|
|
|
```
|
|
20 text/gemini; charset=utf-8; size=1108
|
|
```
|