- From: Christopher Ferris <chris.ferris@sun.com>
- Date: Wed, 03 Oct 2001 15:43:32 -0400
- To: "'xml-dist-app@w3.org'" <xml-dist-app@w3.org>
All, Here is the amended section 6.3 of Part 2 regarding HTTP status codes and the default HTTP binding as we discussed on this week's (03/10) con-call. Cheers, Chris 6.3 SOAP HTTP Response SOAP over HTTP as defined for this default binding follows the semantics of the HTTP Status codes for communicating status information in HTTP. 6.3.1 HTTP 2xx Successful A 2xx status code indicates that the request, including the SOAP message component, was successfully received, understood, and accepted by the receiving SOAP processor. - A 200 OK status SHALL be used to communicate that a SOAP message is being conveyed within the entity body of the HTTP response. The response SOAP message SHALL be implicitly correlated with the request SOAP message sent in the HTTP POST operation. - A 202 Accepted status MAY be returned by the server to indicate that the request SOAP message has been received, but has not been processed. - A 204 No Content status SHALL be used to communicate that the SOAP message has been successfully processed by the SOAP application. As stipulated in [5], the 204 response MUST NOT include a message body. 6.3.2 HTTP 3xx Redirection No SOAP specific behavior is associated with the 3xx status codes. A SOAP client SHOULD be prepared to receive and process a 3xx status code as defined in RFC2616 section 10.3. 6.3.3 HTTP 4xx Client Error In general, a SOAP HTTP client SHOULD be prepared to handle any of the 4xx class of HTTP status codes. However, the following status codes have specific meaning within the context of this SOAP binding to HTTP. - A 400 Bad Request status SHALL be returned in the event that the SOAP message contained within the body of an HTTP request message is not well formed XML or in the case where a SOAP envelope was expected in the body of the HTTP POST request and none was present. - A 405 Method Not Allowed status MAY be returned in the event that the method specified in the HTTP request, containing a SOAP message, is not POST. As specified in RFC2616, the HTTP response MUST include an Accept header that includes at least POST. - A 415 Unsupported Media Type status code SHALL be returned in the event that the encapsulation mechanism used for the SOAP message in the HTTP request is unsupported by the server. 6.3.4 HTTP 5xx Server Error If an error occurs while processing a SOAP HTTP message, that is not covered by any of the conditions expressed above in section 6.3.2, the SOAP HTTP server MUST issue an HTTP 500 "Internal Server Error" response and include a SOAP message in the response containing a SOAP fault (see section 4.4) indicating the SOAP processing error. ---------------------------------------------------------------------
Received on Wednesday, 3 October 2001 15:46:47 UTC