HTTPoison v0.9.0 → Overview → HTTPoison

HTTPoison

Summary
Types
Functions

The HTTP client for Elixir.

The HTTPoison module can be used to issue HTTP requests and parse HTTP responses to arbitrary urls.

iex> HTTPoison.get!("https://api.github.com")
%HTTPoison.Response{status_code: 200,
                    headers: [{"content-type", "application/json"}],
                    body: "{...}"}

It’s very common to use HTTPoison in order to wrap APIs, which is when the HTTPoison.Base module shines. Visit the documentation for HTTPoison.Base for more information.

Under the hood, the HTTPoison module just uses HTTPoison.Base (as described in the documentation for HTTPoison.Base) without overriding any default function.

See request/5 for more details on how to issue HTTP requests

Source

Summary

delete!(url, headers \\ [], options \\ [])	Issues a DELETE request to the given url, raising an exception in case of failure
delete(url, headers \\ [], options \\ [])	Issues a DELETE request to the given url
get!(url, headers \\ [], options \\ [])	Issues a GET request to the given url, raising an exception in case of failure
get(url, headers \\ [], options \\ [])	Issues a GET request to the given url
head!(url, headers \\ [], options \\ [])	Issues a HEAD request to the given url, raising an exception in case of failure
head(url, headers \\ [], options \\ [])	Issues a HEAD request to the given url
options!(url, headers \\ [], options \\ [])	Issues a OPTIONS request to the given url, raising an exception in case of failure
options(url, headers \\ [], options \\ [])	Issues an OPTIONS request to the given url
patch!(url, body, headers \\ [], options \\ [])	Issues a PATCH request to the given url, raising an exception in case of failure
patch(url, body, headers \\ [], options \\ [])	Issues a PATCH request to the given url
post!(url, body, headers \\ [], options \\ [])	Issues a POST request to the given url, raising an exception in case of failure
post(url, body, headers \\ [], options \\ [])	Issues a POST request to the given url
put!(url, body, headers \\ [], options \\ [])	Issues a PUT request to the given url, raising an exception in case of failure
put(url, body, headers \\ [], options \\ [])	Issues a PUT request to the given url
request!(method, url, body \\ "", headers \\ [], options \\ [])	Issues an HTTP request with the given method to the given url, raising an exception in case of failure
request(method, url, body \\ "", headers \\ [], options \\ [])	Issues an HTTP request with the given method to the given url
start()	Starts HTTPoison and its dependencies

Types

headers :: [{binary, binary}] | %{binary => binary}

body :: binary | {:form, [{atom, any}]} | {:file, binary}

Functions

delete(url, headers \\ [], options \\ [])

(function) # ↑

Specs:

delete(binary, headers, Keyword.t) :: {:ok, HTTPoison.Response.t | HTTPoison.AsyncResponse.t} | {:error, HTTPoison.Error.t}

Issues a DELETE request to the given url.

Returns {:ok, response} if the request is successful, {:error, reason} otherwise.

See request/5 for more detailed information.

Source

delete!(url, headers \\ [], options \\ [])

(function) # ↑

Specs:

delete!(binary, headers, Keyword.t) :: HTTPoison.Response.t | HTTPoison.AsyncResponse.t

Issues a DELETE request to the given url, raising an exception in case of failure.

If the request does not fail, the response is returned.

See request!/5 for more detailed information.

Source

get(url, headers \\ [], options \\ [])

(function) # ↑

Specs:

get(binary, headers, Keyword.t) :: {:ok, HTTPoison.Response.t | HTTPoison.AsyncResponse.t} | {:error, HTTPoison.Error.t}

Issues a GET request to the given url.

Returns {:ok, response} if the request is successful, {:error, reason} otherwise.

See request/5 for more detailed information.

Source

get!(url, headers \\ [], options \\ [])

(function) # ↑

Specs:

get!(binary, headers, Keyword.t) :: HTTPoison.Response.t | HTTPoison.AsyncResponse.t

Issues a GET request to the given url, raising an exception in case of failure.

If the request does not fail, the response is returned.

See request!/5 for more detailed information.

Source

head(url, headers \\ [], options \\ [])

(function) # ↑

Specs:

head(binary, headers, Keyword.t) :: {:ok, HTTPoison.Response.t | HTTPoison.AsyncResponse.t} | {:error, HTTPoison.Error.t}

Issues a HEAD request to the given url.

Returns {:ok, response} if the request is successful, {:error, reason} otherwise.

See request/5 for more detailed information.

Source

head!(url, headers \\ [], options \\ [])

(function) # ↑

Specs:

head!(binary, headers, Keyword.t) :: HTTPoison.Response.t | HTTPoison.AsyncResponse.t

Issues a HEAD request to the given url, raising an exception in case of failure.

If the request does not fail, the response is returned.

See request!/5 for more detailed information.

Source

options(url, headers \\ [], options \\ [])

(function) # ↑

Specs:

options(binary, headers, Keyword.t) :: {:ok, HTTPoison.Response.t | HTTPoison.AsyncResponse.t} | {:error, HTTPoison.Error.t}

Issues an OPTIONS request to the given url.

Returns {:ok, response} if the request is successful, {:error, reason} otherwise.

See request/5 for more detailed information.

Source

options!(url, headers \\ [], options \\ [])

(function) # ↑

Specs:

options!(binary, headers, Keyword.t) :: HTTPoison.Response.t | HTTPoison.AsyncResponse.t

Issues a OPTIONS request to the given url, raising an exception in case of failure.

If the request does not fail, the response is returned.

See request!/5 for more detailed information.

Source

patch(url, body, headers \\ [], options \\ [])

(function) # ↑

Specs:

patch(binary, body, headers, Keyword.t) :: {:ok, HTTPoison.Response.t | HTTPoison.AsyncResponse.t} | {:error, HTTPoison.Error.t}

Issues a PATCH request to the given url.

Returns {:ok, response} if the request is successful, {:error, reason} otherwise.

See request/5 for more detailed information.

Source

patch!(url, body, headers \\ [], options \\ [])

(function) # ↑

Specs:

patch!(binary, body, headers, Keyword.t) :: HTTPoison.Response.t | HTTPoison.AsyncResponse.t

Issues a PATCH request to the given url, raising an exception in case of failure.

If the request does not fail, the response is returned.

See request!/5 for more detailed information.

Source

post(url, body, headers \\ [], options \\ [])

(function) # ↑

Specs:

post(binary, body, headers, Keyword.t) :: {:ok, HTTPoison.Response.t | HTTPoison.AsyncResponse.t} | {:error, HTTPoison.Error.t}

Issues a POST request to the given url.

Returns {:ok, response} if the request is successful, {:error, reason} otherwise.

See request/5 for more detailed information.

Source

post!(url, body, headers \\ [], options \\ [])

(function) # ↑

Specs:

post!(binary, body, headers, Keyword.t) :: HTTPoison.Response.t | HTTPoison.AsyncResponse.t

Issues a POST request to the given url, raising an exception in case of failure.

If the request does not fail, the response is returned.

See request!/5 for more detailed information.

Source

put(url, body, headers \\ [], options \\ [])

(function) # ↑

Specs:

put(binary, body, headers, Keyword.t) :: {:ok, HTTPoison.Response.t | HTTPoison.AsyncResponse.t} | {:error, HTTPoison.Error.t}

Issues a PUT request to the given url.

Returns {:ok, response} if the request is successful, {:error, reason} otherwise.

See request/5 for more detailed information.

Source

put!(url, body, headers \\ [], options \\ [])

(function) # ↑

Specs:

put!(binary, body, headers, Keyword.t) :: HTTPoison.Response.t | HTTPoison.AsyncResponse.t

Issues a PUT request to the given url, raising an exception in case of failure.

If the request does not fail, the response is returned.

See request!/5 for more detailed information.

Source

request(method, url, body \\ "", headers \\ [], options \\ [])

(function) # ↑

Specs:

request(atom, binary, body, headers, Keyword.t) :: {:ok, HTTPoison.Response.t | HTTPoison.AsyncResponse.t} | {:error, HTTPoison.Error.t}

Issues an HTTP request with the given method to the given url.

This function is usually used indirectly by get/3, post/4, put/4, etc

Args:

method - HTTP method as an atom (:get, :head, :post, :put, :delete, etc.)
url - target url as a binary string or char list
body - request body. See more below
headers - HTTP headers as an orddict (e.g., [{"Accept", "application/json"}])
options - Keyword list of options

Body:

binary, char list or an iolist
{:form, [{K, V}, ...]} - send a form url encoded
{:file, "/path/to/file"} - send a file

Options:

:timeout - timeout to establish a connection, in milliseconds. Default is 8000
:recv_timeout - timeout used when receiving a connection. Default is 5000
:stream_to - a PID to stream the response to
:proxy - a proxy to be used for the request; it can be a regular url or a {Host, Proxy} tuple
:proxy_auth - proxy authentication {User, Password} tuple
:ssl - SSL options supported by the ssl erlang module
:follow_redirect - a boolean that causes redirects to be followed
:max_redirect - an integer denoting the maximum number of redirects to follow
:params - an enumerable consisting of two-item tuples that will be appended to the url as query string parameters

Timeouts can be an integer or :infinity

This function returns {:ok, response} or {:ok, async_response} if the request is successful, {:error, reason} otherwise.

Examples

request(:post, "https://my.website.com", "{\"foo\": 3}", [{"Accept", "application/json"}])

Source

request!(method, url, body \\ "", headers \\ [], options \\ [])

(function) # ↑

Specs:

request!(atom, binary, body, headers, Keyword.t) :: HTTPoison.Response.t

Issues an HTTP request with the given method to the given url, raising an exception in case of failure.

request!/5 works exactly like request/5 but it returns just the response in case of a successful request, raising an exception in case the request fails.

Source

start()

(function) # ↑

Starts HTTPoison and its dependencies.

Source