Skip to content

Commit

Permalink
Editorial changes to Safe Method With Body
Browse files Browse the repository at this point in the history
A minor typographical fix and slight rephrasing of limitations of current query-embedded-in-request-URI method.
  • Loading branch information
hawkinsw authored Aug 7, 2024
1 parent 8dec5fc commit d091f85
Showing 1 changed file with 9 additions and 13 deletions.
22 changes: 9 additions & 13 deletions draft-ietf-httpbis-safe-method-w-body.xml
Original file line number Diff line number Diff line change
Expand Up @@ -99,8 +99,8 @@

<t>
Most often, this is desirable when the data conveyed in a request is
too voluminous to be encoded into the request's URI. For example, while
this is an common and interoperable query:
too voluminous to be encoded into the request's URI. For example,
this is a common and interoperable query:
</t>

<artwork type="http-message">
Expand All @@ -109,17 +109,13 @@ Host: example.org
</artwork>

<t>
if the query parameters extend to several kilobytes or more of
data it may not be, because many implementations place limits on their size. Often these limits are not
known or discoverable ahead of time, because a request can pass through many uncoordinated
systems. Additionally, expressing some data in the target URI is inefficient, because it
needs to be encoded to be a valid URI.
</t>

<t>
Encoding query parameters directly into the request URI also effectively
casts every possible combination of query inputs as distinct
resources. Depending on the application, that may not be desirable.
However, for a query with parameters that extend to several kilobytes or more of
data, encoding it in the request URI may not be the best option because
<ul>
<li>many implementations place limitations on query size (and those limits are not discoverable ahead of time),</li>
<li>expressing some data in the target URI is inefficient because of the overhead of encoding that data into a valid URI, and</li>
<li>encoding query parameters directly into the request URI effectively casts every possible combination of query inputs as distinct resources.</li>
</ul>
</t>

<t>
Expand Down

0 comments on commit d091f85

Please sign in to comment.