Skip to content

Commit

Permalink
query: add overview table to introduction
Browse files Browse the repository at this point in the history
  • Loading branch information
reschke committed Nov 15, 2024
1 parent 806f026 commit dd2cacd
Showing 1 changed file with 38 additions and 0 deletions.
38 changes: 38 additions & 0 deletions draft-ietf-httpbis-safe-method-w-body.xml
Original file line number Diff line number Diff line change
Expand Up @@ -164,6 +164,44 @@ q=foo&limit=10&sort=-published
rather than as part of the request URI. Unlike POST, however, the method is explicitly safe
and idempotent, allowing functions like caching and automatic retries to operate.
</t>
<t>Summarizing:</t>
<table>
<thead>
<tr>
<th/>
<th>GET</th>
<th>QUERY</th>
<th>POST</th>
</tr>
</thead>
<tbody>
<tr>
<td>Safe</td>
<td>yes</td>
<td>yes</td>
<td>potentially no</td>
</tr>
<tr>
<td>Idempotent</td>
<td>yes</td>
<td>yes</td>
<td>potentially no</td>
</tr>
<tr>
<td>Cacheable</td>
<td>yes</td>
<td>yes</td>
<td>no</td>
</tr>
<tr>
<td>Content (body)</td>
<td>"no defined semantics"</td>
<td>expected (semantics per target resource)</td>
<td>expected (semantics per target resource)</td>
</tr>
</tbody>
</table>


<t>
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
Expand Down

0 comments on commit dd2cacd

Please sign in to comment.