Perform an HTTP request and return the body as a lazy ByteString. Note that the entire value will be read into memory at once (no lazy I/O will be performed).

Since: 2.1.10

Perform an HTTP request and parse the body as JSON. In the event of an JSON parse errors, a JSONException runtime exception will be thrown.

Since: 2.1.10

Perform an HTTP request and parse the body as JSON. In the event of an JSON parse errors, a Left value will be returned.

Since: 2.1.10

Perform an HTTP request and consume the body with the given Sink

Since: 2.1.10

All information on how to connect to a host and what should be sent in the HTTP request.

If you simply wish to download from a URL, see parseRequest.

The constructor for this data type is not exposed. Instead, you should use either the defaultRequest value, or parseRequest to construct from a URL, and then use the records below to make modifications. This approach allows http-client to add configuration options without breaking backwards compatibility.

For example, to construct a POST request, you could do something like:

initReq <- parseRequest "http://www.example.com/path"
let req = initReq
            { method = "POST"
            }

For more information, please see http://www.yesodweb.com/book/settings-types.

Since 0.1.0

A simple representation of the HTTP response.

Since 0.1.0

An exception that can occur when parsing JSON

Since: 2.1.10

Define a HTTP proxy, consisting of a hostname and port number.

A default request value

Since: 0.4.30

Convert a URL into a Request.

This defaults some of the values in Request, such as setting method to GET and requestHeaders to [].

Since this function uses MonadThrow, the return monad can be anything that is an instance of MonadThrow, such as IO or Maybe.

You can place the request method at the beginning of the URL separated by a space, e.g.:

@@ parseRequeset "POST http://httpbin.org/post" @@

Note that the request method must be provided as all capital letters.

Since: 0.4.30

Same as parseRequest, but in the cases of a parse error generates an impure exception. Mostly useful for static strings which are known to be correctly formatted.

Set the request method

Since: 2.1.10

Set whether this is a secureHTTPS (True) or insecureHTTP (False) request

Since: 2.1.10

Set the destination host of the request

Since: 2.1.10

Set the destination port of the request

Since: 2.1.10

Lens for the requested path info of the request

Since: 2.1.10

Add a request header name/value combination

Since: 2.1.10

Get all request header values for the given name

Since: 2.1.10

Set the given request header to the given list of values. Removes any previously set header values with the same name.

Since: 2.1.10

Set the request headers, wiping out any previously set headers

Since: 2.1.10

Set the query string parameters

Since: 2.1.10

Get the query string parameters

Since: 2.1.10

Set the request body to the given RequestBody. You may want to consider using one of the convenience functions in the modules, e.g. requestBodyJSON.

Note: This will not modify the request method. For that, please use requestMethod. You likely don't want the default of GET.

Since: 2.1.10

Set the request body as a JSON value

Note: This will not modify the request method. For that, please use requestMethod. You likely don't want the default of GET.

This also sets the content-type to application/json; chatset=utf8

Since: 2.1.10

Set the request body as a lazy ByteString

Note: This will not modify the request method. For that, please use requestMethod. You likely don't want the default of GET.

Since: 2.1.10

Set the request body as a Source

Note: This will not modify the request method. For that, please use requestMethod. You likely don't want the default of GET.

Since: 2.1.10

Set the request body as a file

Note: This will not modify the request method. For that, please use requestMethod. You likely don't want the default of GET.

Since: 2.1.10

Set the request body as URL encoded data

Note: This will not modify the request method. For that, please use requestMethod. You likely don't want the default of GET.

This also sets the content-type to application/x-www-form-urlencoded

Since: 2.1.10

Modify the request so that non-2XX status codes do not generate a runtime exception.

Since: 2.1.10

Set basic auth with the given username and password

Since: 2.1.10

Instead of using the default global Manager, use the supplied Manager.

Since: 2.1.10

Override the default proxy server settings

Since: 2.1.10

Get the status of the response

Since: 2.1.10

Get the integral status code of the response

Since: 2.1.10

Get all response header values with the given name

Since: 2.1.10

Get all response headers

Since: 2.1.10

Get the response body

Since: 2.1.10

Alternate spelling of httpLBS

Since: 2.1.10