File tree 1 file changed +18
-3
lines changed 1 file changed +18
-3
lines changed Original file line number Diff line number Diff line change @@ -1378,12 +1378,27 @@ GET /foo/
1378
1378
other similarly structured headers wherever possible.
1379
1379
</t >
1380
1380
<t >
1381
- The "Prefer" header defined in <xref target =" RFC7240" >RFC 7240</xref >
1382
- is a good candidate for description in "headerSchema". It defines
1383
- several standard values and allows for extension values.
1381
+ It is RECOMMENDED that schema authors describe the available usage of
1382
+ the following types of HTTP headers whenever applicable:
1383
+ <list style =" symbols" >
1384
+ <t >Content negotiation</t >
1385
+ <t >Authentication and authorization</t >
1386
+ <t >Range requests</t >
1387
+ <t >The "Prefer" header</t >
1388
+ </list >
1389
+ </t >
1390
+ <t >
1391
+ Headers such as cache control and conditional request headers are generally
1392
+ implemented by intermediaries rather than the resource, and are therefore
1393
+ not generally useful to describe. While the resource must supply the
1394
+ information needed to use conditional requests, the runtime handling of
1395
+ such headers and related responses is not resource-specific.
1384
1396
</t >
1385
1397
<figure >
1386
1398
<preamble >
1399
+ The "Prefer" header defined in <xref target =" RFC7240" >RFC 7240</xref >
1400
+ is a good candidate for description in "headerSchema". It defines
1401
+ several standard values and allows for extension values.
1387
1402
This schema indicates that the target understands the
1388
1403
"respond-async" preference, the "wait" preference which
1389
1404
takes a number of seconds to wait, as well as "minimal" and
You can’t perform that action at this time.
0 commit comments