Ignore:
Timestamp:
Dec 20, 2012, 1:33:38 AM (7 years ago)
Author:
fielding@…
Message:

editorial improvements to 3xx status codes; partly addresses #419

File:
1 edited

Legend:

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

    r2055 r2056  
    28262826  <iref primary="true" item="Status Codes Classes" subitem="3xx Redirection" x:for-anchor=""/>
    28272827<t>
    2828    This class of status code indicates that further action needs to be
    2829    taken by the user agent in order to fulfill the request.
     2828   The <x:dfn>3xx (Redirection)</x:dfn> class of status code indicates that
     2829   further action needs to be taken by the user agent in order to fulfill the
     2830   request.
    28302831</t>
    28312832<t>
     
    29092910  <x:anchor-alias value="300 (Multiple Choices)"/>
    29102911<t>
    2911    The target resource has more than one
    2912    representation, each with its own specific location, and reactive
    2913    negotiation information (&content-negotiation;) is being provided so that
    2914    the user (or user agent) can select a preferred representation by
    2915    redirecting its request to that location.
    2916 </t>
    2917 <t>
    2918    Unless it was a HEAD request, the response &SHOULD; include a representation
    2919    containing a list of representation metadata and location(s) from
    2920    which the user or user agent can choose the one most appropriate. Depending
    2921    upon the format and the capabilities of
    2922    the user agent, selection of the most appropriate choice &MAY; be
    2923    performed automatically. However, this specification does not define
    2924    any standard for such automatic selection.
    2925 </t>
    2926 <t>
    2927    If the server has a preferred choice of representation, it &SHOULD;
    2928    include the specific URI for that representation in the <x:ref>Location</x:ref>
    2929    field; user agents &MAY; use the Location field value for automatic
    2930    redirection.
     2912   The <x:dfn>300 (Multiple Choices)</x:dfn> status code indicates that the
     2913   target resource has more than one representation, each with its own more
     2914   specific identifier, and information about the alternatives is being
     2915   provided so that the user (or user agent) can select a preferred
     2916   representation by redirecting its request to one or more of those
     2917   identifiers. In other words, the server desires that the user agent engage
     2918   in reactive negotiation to select the most appropriate representation(s)
     2919   for its needs (&content-negotiation;).
     2920</t>
     2921<t>
     2922   For request methods other than HEAD, the server &SHOULD; generate a payload
     2923   in the 300 response containing a list of representation metadata and URI
     2924   reference(s) from which the user or user agent can choose the one most
     2925   preferred. The user agent &MAY; make a selection from that list
     2926   automatically, depending upon the list format, but this specification does
     2927   not define a standard for such automatic selection.
     2928</t>
     2929<t>
     2930   If the server has a preferred choice, the server &SHOULD; generate a
     2931   <x:ref>Location</x:ref> header field containing a preferred choice's URI
     2932   reference. The user agent &MAY; use the Location field value for automatic
     2933   redirection.
    29312934</t>
    29322935<t>
     
    29422945  <x:anchor-alias value="301 (Moved Permanently)"/>
    29432946<t>
    2944    The target resource has been assigned a new permanent URI and any
    2945    future references to this resource &SHOULD; use one of the enclosed
    2946    URIs.  Clients with link editing capabilities ought to automatically
    2947    re-link references to the effective request URI to one or more of the new
    2948    references sent by the server, where possible.
    2949 </t>
    2950 <t>
    2951    Caches &MAY; use a heuristic (see &p6-heuristic;) to determine
    2952    freshness for 301 responses.
    2953 </t>
    2954 <t>
    2955    The new permanent URI &SHOULD; be given by the <x:ref>Location</x:ref> field
    2956    in the response. A response payload can contain a short hypertext note with a
    2957    hyperlink to the new URI(s).
     2947   The <x:dfn>301 (Moved Permanently)</x:dfn> status code indicates that the
     2948   target resource has been assigned a new permanent URI and any future
     2949   references to this resource ought to use one of the enclosed URIs. Clients
     2950   with link editing capabilities ought to automatically re-link references to
     2951   the effective request URI to one or more of the new references sent by the
     2952   server, where possible.
     2953</t>
     2954<t>
     2955   The server &SHOULD; generate a <x:ref>Location</x:ref> header field in the
     2956   response containing a preferred URI reference for the new permanent URI.
     2957   The user agent &MAY; use the Location field value for automatic redirection.
     2958   The server's response payload usually contains a short hypertext note with
     2959   a hyperlink to the new URI(s).
    29582960</t>
    29592961<x:note>
     
    29652967  </t>
    29662968</x:note>
     2969<t>
     2970   Caches &MAY; use a heuristic (see &p6-heuristic;) to determine
     2971   freshness for 301 responses.
     2972</t>
    29672973</section>
    29682974
     
    29722978  <x:anchor-alias value="302 (Found)"/>
    29732979<t>
    2974    The target resource resides temporarily under a different URI.
    2975    Since the redirection might be altered on occasion, the client &SHOULD;
    2976    continue to use the effective request URI for future requests.
    2977 </t>
    2978 <t>
    2979    The temporary URI &SHOULD; be given by the <x:ref>Location</x:ref> field in
    2980    the response. A response payload can contain a short hypertext note with a
    2981    hyperlink to the new URI(s).
     2980   The <x:dfn>302 (Found)</x:dfn> status code indicates that the target
     2981   resource resides temporarily under a different URI. Since the redirection
     2982   might be altered on occasion, the client ought to continue to use the
     2983   effective request URI for future requests.
     2984</t>
     2985<t>
     2986   The server &SHOULD; generate a <x:ref>Location</x:ref> header field in the
     2987   response containing a URI reference for the different URI.
     2988   The user agent &MAY; use the Location field value for automatic redirection.
     2989   The server's response payload usually contains a short hypertext note with
     2990   a hyperlink to the different URI(s).
    29822991</t>
    29832992<x:note>
     
    29953004  <x:anchor-alias value="303 (See Other)"/>
    29963005<t>
    2997    The 303 status code indicates that the server is redirecting the
    2998    user agent to a different resource, as indicated by a URI in the
    2999    <x:ref>Location</x:ref> header field, that is intended to provide an indirect
    3000    response to the original request.  In order to satisfy the original
    3001    request, a user agent &SHOULD; perform a retrieval request using the
    3002    Location URI (a GET or HEAD request if using HTTP), which
    3003    can itself be redirected further, and present the eventual result as an
    3004    answer to the original request.
    3005    Note that the new URI in the Location header field is not considered
    3006    equivalent to the effective request URI.
    3007 </t>
    3008 <t>
    3009    This status code is generally applicable to any HTTP method.  It is
     3006   The <x:dfn>303 (See Other)</x:dfn> status code indicates that the server is
     3007   redirecting the user agent to a different resource, as indicated by a URI
     3008   in the <x:ref>Location</x:ref> header field, that is intended to provide an
     3009   indirect response to the original request. In order to satisfy the original
     3010   request, a user agent ought to perform a retrieval request using the
     3011   Location URI (a GET or HEAD request if using HTTP), which can itself be
     3012   redirected further, and present the eventual result as an answer to the
     3013   original request. Note that the new URI in the Location header field is not
     3014   considered equivalent to the effective request URI.
     3015</t>
     3016<t>
     3017   This status code is applicable to any HTTP method.  It is
    30103018   primarily used to allow the output of a POST action to redirect
    30113019   the user agent to a selected resource, since doing so provides the
     
    30283036<t>
    30293037   Except for responses to a HEAD request, the representation of a 303
    3030    response &SHOULD; contain a short hypertext note with a hyperlink
    3031    to the <x:ref>Location</x:ref> URI.
     3038   response ought to contain a short hypertext note with a hyperlink to the
     3039   same URI reference provided in the <x:ref>Location</x:ref> header field.
    30323040</t>
    30333041</section>
     
    30373045  <x:anchor-alias value="305 (Use Proxy)"/>
    30383046<t>
    3039    The 305 status code was defined in a previous version of this specification
    3040    (see <xref target="changes.from.rfc.2616"/>), and is now deprecated.
     3047   The <x:dfn>305 (Use Proxy)</x:dfn> status code was defined in a previous
     3048   version of this specification and is now deprecated
     3049   (<xref target="changes.from.rfc.2616"/>).
    30413050</t>
    30423051</section>
     
    30453054  <iref primary="true" item="306 (Unused) (status code)" x:for-anchor=""/>
    30463055<t>
    3047    The 306 status code was used in a previous version of the
     3056   The 306 status code was defined in a previous version of this
    30483057   specification, is no longer used, and the code is reserved.
    30493058</t>
     
    30553064  <x:anchor-alias value="307 (Temporary Redirect)"/>
    30563065<t>
    3057    The target resource resides temporarily under a different URI.
    3058    Since the redirection can change over time, the client &SHOULD;
    3059    continue to use the effective request URI for future requests.
    3060 </t>
    3061 <t>
    3062    The temporary URI &SHOULD; be given by the <x:ref>Location</x:ref> field in
    3063    the response. A response payload can contain a short hypertext note with a
    3064    hyperlink to the new URI(s).
     3066   The <x:dfn>307 (Temporary Redirect)</x:dfn> status code indicates that the
     3067   target resource resides temporarily under a different URI and the
     3068   user agent &MUST-NOT; change the request method if it performs an automatic
     3069   redirection to that URI.
     3070   Since the redirection can change over time, the client ought to continue
     3071   using the original effective request URI for future requests.
     3072</t>
     3073<t>
     3074   The server &SHOULD; generate a <x:ref>Location</x:ref> header field in the
     3075   response containing a URI reference for the different URI.
     3076   The user agent &MAY; use the Location field value for automatic redirection.
     3077   The server's response payload usually contains a short hypertext note with
     3078   a hyperlink to the different URI(s).
    30653079</t>
    30663080<x:note>
    30673081  <t>
    30683082    &Note; This status code is similar to <x:ref>302 (Found)</x:ref>, except
    3069     that it does not allow rewriting the request method from POST to GET. This
     3083    that it does not allow changing the request method from POST to GET. This
    30703084    specification defines no equivalent counterpart for <x:ref>301 (Moved
    30713085    Permanently)</x:ref> (<xref target="status-308"/>,
     
    30823096  <iref primary="true" item="Status Codes Classes" subitem="4xx Client Error" x:for-anchor=""/>
    30833097<t>
    3084    The 4xx class of status code is intended for cases in which the
    3085    client seems to have erred. Except when responding to a HEAD request,
    3086    the server &SHOULD; include a representation containing an explanation of the
    3087    error situation, and whether it is a temporary or permanent
    3088    condition. These status codes are applicable to any request method.
    3089    User agents &SHOULD; display any included representation to the user.
     3098   The <x:dfn>4xx (Client Error)</x:dfn> class of status code indicates that
     3099   the client seems to have erred. Except when responding to a HEAD request,
     3100   the server &SHOULD; send a representation containing an explanation of
     3101   the error situation, and whether it is a temporary or permanent condition.
     3102   These status codes are applicable to any request method. User agents
     3103   &SHOULD; display any included representation to the user.
    30903104</t>
    30913105
     
    31013115<section title="402 Payment Required" anchor="status.402">
    31023116  <iref primary="true" item="402 Payment Required (status code)" x:for-anchor=""/>
    3103 <t>
    3104    This code is reserved for future use.
     3117  <x:anchor-alias value="402 (Payment Required)"/>
     3118<t>
     3119   The <x:dfn>402 (Payment Required)</x:dfn> status code is reserved for
     3120   future use.
    31053121</t>
    31063122</section>
Note: See TracChangeset for help on using the changeset viewer.