You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: draft-ietf-httpapi-link-hint.md
+19-4Lines changed: 19 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,6 +36,10 @@ normative:
36
36
URI: RFC3986
37
37
STRUCTURED-FIELDS: RFC9651
38
38
39
+
informative:
40
+
PATCH: RFC5789
41
+
QUERY: I-D.ietf-httpbis-safe-method-w-body
42
+
39
43
40
44
--- abstract
41
45
@@ -110,13 +114,25 @@ When this hint is present, "POST" SHOULD be listed in the "allow" hint when pres
110
114
## accept-patch
111
115
112
116
* 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.
114
118
* Content Model: Inner List of Strings
115
119
* Specification: \[this document]
116
120
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}}).
118
134
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.
120
136
121
137
## accept-ranges
122
138
@@ -178,7 +194,6 @@ Content MUST be a Token; possible values are:
178
194
* gone - indicates that the resource is no longer available; i.e., it will return a 410 (Gone) HTTP status code if accessed.
179
195
180
196
181
-
182
197
# Security Considerations
183
198
184
199
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