Changes

If <code><http:header name="Accept-Encoding" value="gzip"/></code> is specified and if the addressed web server provides support for the {{Code|gzip}} compression algorithm, the response will automatically be decompressed.

=Conventions=

{| width='100%'

| width='120' | '''Signatures'''

|{{Func|http:send-request|$request as element(http:request)|item()+}}<br />{{Func|http:send-request|$request as element(http:request)?, $href as xs:string?|item()+}}<br />{{Func|http:send-request|$request as element(http:request)?, $href as xs:string?, $bodies as item()*|item()+}}<br/>

| '''Summary'''

|Sends an HTTP request and interprets the corresponding response:

* While the contents of the request can be supplied as child of the {{Code|http:body}} element, it is faster and safer to pass them on via the third argument.

* For further information, please check out the [http://expath.org/spec/http-client EXPath] specification.

|'''Errors'''

|{{Error|HC0001|#Errors}} an HTTP error occurred.<br/>{{Error|HC0002|#Errors}} error parsing the entity content as XML or HTML.<br/>{{Error|HC0003|#Errors}} with a multipart response, the override-media-type must be either a multipart media type or application/octet-stream.<br/>{{Error|HC0004|#Errors}} the src attribute on the body element is mutually exclusive with all other attribute (except the media-type).<br/>{{Error|HC0005|#Errors}} the request element is not valid.<br/>{{Error|HC0006|#Errors}} a timeout occurred waiting for the response.

<http:body media-type='application/xml'/>

</http:request>,

<query>

<text>

</http:multipart>

</http:request>,

file:read-binary($path)

)

! width="110"|Code

|Description

|{{Code|HC0001}}

|An HTTP error occurred.

|{{Code|HC0002}}

|Error parsing the entity content as XML or HTML.

|{{Code|HC0003}}

|With a multipart response, the override-media-type must be either a multipart media type or application/octet-stream.

|{{Code|HC0004}}

|The src attribute on the body element is mutually exclusive with all other attribute (except the media-type).

|{{Code|HC0005}}

|The request element is not valid.

|{{Code|HC0006}}

|A timeout occurred waiting for the response.

=Changelog=

;Version 9.0

;Version 7.6

* Updated: errors are using {{Code|text/plain}} as media-type.