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: 0.2.4

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: 0.2.4

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: 0.2.4

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

Since: 0.2.4

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: 0.2.4

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

The default request value. You'll almost certainly want to set the requestHost, and likely the requestPath as well.

See also parseRequest

Since: 0.2.4

Parse a Request from a String. This is given as a URL, with an optional leading request method, e.g.:

• http://example.com

• https://example.com:1234/foo/bar?baz=bin

• PUT http://example.com/some-resource

If parsing fails, throwM will be called. The behavior of this function is also used for the IsString instance for use with OverloadedStrings.

Since: 0.2.4

Set the request method

Since: 0.2.4

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

Since: 0.2.4

Set the destination host of the request

Since: 0.2.4

Set the destination port of the request

Since: 0.2.4

Lens for the requested path info of the request

Since: 0.2.4

Add a request header name/value combination

Since: 0.2.4

Get all request header values for the given name

Since: 0.2.4

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

Since: 0.2.4

Set the request headers, wiping out any previously set headers

Since: 0.2.4

Set the query string parameters

Since: 0.2.4

Get the query string parameters

Since: 0.2.4

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: 0.2.4

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: 0.2.4

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: 0.2.4

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: 0.2.4

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: 0.2.4

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: 0.2.4

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

Since: 0.2.4

Set basic auth with the given username and password

Since: 0.2.4

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

Since: 0.2.4

Override the default proxy server settings

Since: 0.2.4

Get the status of the response

Since: 0.2.4

Get the integral status code of the response

Since: 0.2.4

Get all response header values with the given name

Since: 0.2.4

Get all response headers

Since: 0.2.4

Get the response body

Since: 0.2.4

Alternate spelling of httpLBS

Since: 0.2.4