Skip to content

Commit 8ec1f27

Browse files
committed
Add accept-query
Fixes #8.
1 parent e164fc6 commit 8ec1f27

File tree

1 file changed

+19
-4
lines changed

1 file changed

+19
-4
lines changed

draft-ietf-httpapi-link-hint.md

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,10 @@ normative:
3636
URI: RFC3986
3737
STRUCTURED-FIELDS: RFC9651
3838

39+
informative:
40+
PATCH: RFC5789
41+
QUERY: I-D.ietf-httpbis-safe-method-w-body
42+
3943

4044
--- abstract
4145

@@ -110,13 +114,25 @@ When this hint is present, "POST" SHOULD be listed in the "allow" hint when pres
110114
## accept-patch
111115

112116
* Hint Name: accept-patch
113-
* Description: Hints the PATCH {{!RFC5789}} request format(s) that the target resource can consume; equivalent to the Accept-Patch HTTP response header.
117+
* Description: Hints the PATCH {{PATCH}} request format(s) that the target resource can consume; equivalent to the Accept-Patch HTTP response header.
114118
* Content Model: Inner List of Strings
115119
* Specification: \[this document]
116120

117-
Content MUST be a Inner List of Strings, containing media types ({{Section 8.3.1 of HTTP}}) that identify the acceptable patch formats.
121+
Content MUST be an Inner List of Strings, containing media types ({{Section 8.3.1 of HTTP}}) that identify the acceptable patch formats (see {{PATCH}}).
122+
123+
When this hint is present, "PATCH" SHOULD be listed in the "allow" hint, when it is present.
124+
125+
## accept-query
126+
127+
* Hint name: accept-query
128+
* Description: Hints the QUERY {{QUERY}} request format(s) that the target resource can consume;
129+
equivalent to the Accept-Query HTTP response header.
130+
* Content Model: Inner List (of Strings)
131+
* Specification: \[this document]
132+
133+
Content MUST be an Inner List of Strings, containing media types ({{Section 8.3.1 of HTTP}}) that identify the acceptable query formats (see {{QUERY}}).
118134

119-
When this hint is present, "PATCH" SHOULD be listed in the "allow" hint when present.
135+
When this hint is present, "QUERY" SHOLD be listed in the "allow" hint, when it is present.
120136

121137
## accept-ranges
122138

@@ -178,7 +194,6 @@ Content MUST be a Token; possible values are:
178194
* gone - indicates that the resource is no longer available; i.e., it will return a 410 (Gone) HTTP status code if accessed.
179195

180196

181-
182197
# Security Considerations
183198

184199
Clients need to exercise care when using hints. For example, a naive client might send credentials to a server that uses the auth-req hint, without checking to see if those credentials are appropriate for that server.

0 commit comments

Comments
 (0)