Ignore:
Timestamp:
Jul 6, 2012, 7:48:51 AM (7 years ago)
Author:
julian.reschke@…
Message:

Work-in-progress: hyperlink status codes definitions (P2)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p2-semantics.xml

    r1734 r1735  
    542542</t>
    543543<t>
    544    A 200 response &SHOULD; include any header fields that indicate
    545    optional features implemented by the server and applicable to that
     544   A <x:ref>200 (OK)</x:ref> response &SHOULD; include any header fields that
     545   indicate optional features implemented by the server and applicable to that
    546546   resource (e.g., Allow), possibly including extensions not defined by
    547547   this specification. The response body, if any, &SHOULD; also include
     
    15871587    <x:ref>307 (Temporary Redirect)</x:ref>, for which the backwards
    15881588    compatibility problems did not apply (<xref target="RFC2616" x:fmt="," x:sec="10.3.8"/>).
    1589     Over 10 years later, most user agents still do method rewriting for
    1590     status codes 301 and 302, therefore this specification makes that behavior
     1589    Over 10 years later, most user agents still do method rewriting for status codes
     1590    <x:ref>301</x:ref> and <x:ref>302</x:ref>, therefore this specification makes that behavior
    15911591    conformant in case the original request was POST.
    15921592  </t>
     
    16501650  <iref primary="true" item="301 Moved Permanently (status code)" x:for-anchor=""/>
    16511651  <iref primary="true" item="Status Codes" subitem="301 Moved Permanently" x:for-anchor=""/>
     1652  <x:anchor-alias value="301"/>
    16521653  <x:anchor-alias value="301 (Moved Permanently)"/>
    16531654<t>
     
    16801681  <iref primary="true" item="302 Found (status code)" x:for-anchor=""/>
    16811682  <iref primary="true" item="Status Codes" subitem="302 Found" x:for-anchor=""/>
     1683  <x:anchor-alias value="302"/>
    16821684  <x:anchor-alias value="302 (Found)"/>
    16831685<t>
     
    17661768  <iref primary="true" item="307 Temporary Redirect (status code)" x:for-anchor=""/>
    17671769  <iref primary="true" item="Status Codes" subitem="307 Temporary Redirect" x:for-anchor=""/>
     1770  <x:anchor-alias value="307"/>
    17681771  <x:anchor-alias value="307 (Temporary Redirect)"/>
    17691772<t>
     
    21472150  <t>
    21482151    <x:h>Note</x:h> to implementors: some deployed proxies are known to
    2149     return 400 or 500 when DNS lookups time out.
     2152    return <x:ref>400 (Bad Request)</x:ref> or <x:ref>500 (Internal Server
     2153    Error)</x:ref> when DNS lookups time out.
    21502154  </t>
    21512155</x:note>
     
    27082712   the response payload is a representation of the target resource.</t>
    27092713   <t>If the response status code is <x:ref>204 (No Content)</x:ref>,
    2710    <x:ref>206 (Partial Content</x:ref>, or <x:ref>304 (Not Modified)</x:ref>
     2714   <x:ref>206 (Partial Content)</x:ref>, or <x:ref>304 (Not Modified)</x:ref>
    27112715   and the request method was GET or HEAD, the response payload is a partial
    27122716   representation of the target resource.</t>
     
    27342738   Representation header fields define metadata about the representation data
    27352739   enclosed in the message body or, if no message body is present, about
    2736    the representation that would have been transferred in a 200 response
    2737    to a simultaneous GET request with the same effective request URI.
     2740   the representation that would have been transferred in a <x:ref>200 (OK)</x:ref>
     2741   response to a simultaneous GET request with the same effective request URI.
    27382742</t>
    27392743<t>
     
    34543458   as a specific identifier for the representation in this message.
    34553459   In other words, if one were to perform a GET on this URI at the time
    3456    of this message's generation, then a 200 response would contain the
    3457    same representation that is enclosed as payload in this message.
     3460   of this message's generation, then a <x:ref>200 (OK)</x:ref> response would
     3461   contain the same representation that is enclosed as payload in this message.
    34583462</t>
    34593463<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Location"/>
     
    34923496   available (for future access with GET) at the given URI.  For
    34933497   example, a purchase transaction made via a POST request might
    3494    include a receipt document as the payload of the 200 response;
    3495    the Content-Location value provides an identifier for retrieving
     3498   include a receipt document as the payload of the <x:ref>200 (OK)</x:ref>
     3499   response; the Content-Location value provides an identifier for retrieving
    34963500   a copy of that same receipt in the future.
    34973501</t>
     
    37323736<t>
    37333737   For <x:ref>201 (Created)</x:ref> responses, the Location is the URI of the
    3734    new resource which was created by the request. For <x:ref>3xx</x:ref> responses, the
    3735    location &SHOULD; indicate the server's preferred URI for automatic
    3736    redirection to the resource.
     3738   new resource which was created by the request. For <x:ref>3xx (Redirection)</x:ref>
     3739   responses, the location &SHOULD; indicate the server's preferred URI for
     3740   automatic redirection to the resource.
    37373741</t>
    37383742<t>
     
    54705474</t>
    54715475<t>
    5472   Status codes 301, 302, and 307: removed the normative requirements on both
    5473   response payloads and user interaction.
     5476  Status codes <x:ref>301</x:ref>, <x:ref>302</x:ref>, and <x:ref>307</x:ref>:
     5477  removed the normative requirements on both response payloads and user interaction.
    54745478  (<xref target="status.3xx"/>)
    54755479</t>
     
    54795483  that determination based on the request method semantics.
    54805484  Furthermore, allow user agents to rewrite the method from POST to GET
    5481   for status codes 301 and 302.
     5485  for status codes <x:ref>301</x:ref> and <x:ref>302</x:ref>.
    54825486  (Sections <xref format="counter" target="status.301"/>,
    54835487  <xref format="counter" target="status.302"/> and
Note: See TracChangeset for help on using the changeset viewer.