mandrill v0.4.1 → Overview → Mandrill

Mandrill

Summary
Types
Functions

An HTTP client for Mandrill.

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
key()	Grabs MANDRILL_KEY from system ENV Returns binary
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
process_response_body(body)	Converts the binary keys in our response to atoms. Args: body - string binary response Returns Record or ArgumentError
process_url(endpoint)	Creates the URL for our endpoint. Args: endpoint - part of the API we’re hitting Returns string
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(endpoint, body)	Boilerplate code to make requests. Args: endpoint - string requested API endpoint body - request body Returns dict
request(method, url, body \\ "", headers \\ [], options \\ [])	Issues an HTTP request with the given method to the given url
start()	Starts HTTPoison and its dependencies
start(type, args)	Callback implementation of `:application.start/2`

Types ↑

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

Functions

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

(function) # ↑

Specs:

delete(binary, headers, [{atom, any}]) :: {: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.

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

(function) # ↑

Specs:

delete!(binary, headers, [{atom, any}]) :: 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.

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

(function) # ↑

Specs:

get(binary, headers, [{atom, any}]) :: {: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.

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

(function) # ↑

Specs:

get!(binary, headers, [{atom, any}]) :: 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.

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

(function) # ↑

Specs:

head(binary, headers, [{atom, any}]) :: {: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.

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

(function) # ↑

Specs:

head!(binary, headers, [{atom, any}]) :: 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.

key()

(function) # ↑

Grabs MANDRILL_KEY from system ENV Returns binary

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

(function) # ↑

Specs:

options(binary, headers, [{atom, any}]) :: {: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.

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

(function) # ↑

Specs:

options!(binary, headers, [{atom, any}]) :: 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.

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

(function) # ↑

Specs:

patch(binary, binary, headers, [{atom, any}]) :: {: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.

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

(function) # ↑

Specs:

patch!(binary, binary, headers, [{atom, any}]) :: 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.

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

(function) # ↑

Specs:

post(binary, binary, headers, [{atom, any}]) :: {: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.

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

(function) # ↑

Specs:

post!(binary, binary, headers, [{atom, any}]) :: 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.

process_response_body(body)

(function) # ↑

Converts the binary keys in our response to atoms. Args:

body - string binary response Returns Record or ArgumentError

process_url(endpoint)

(function) # ↑

Creates the URL for our endpoint. Args:

endpoint - part of the API we’re hitting Returns string

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

(function) # ↑

Specs:

put(binary, binary, headers, [{atom, any}]) :: {: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.

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

(function) # ↑

Specs:

put!(binary, binary, headers, [{atom, any}]) :: 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.

request(endpoint, body)

(function) # ↑

Boilerplate code to make requests. Args:

endpoint - string requested API endpoint
body - request body Returns dict

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

(function) # ↑

Specs:

request(atom, binary, binary, headers, [{atom, any}]) :: {:ok, HTTPoison.Response.t | HTTPoison.AsyncResponse.t} | {:error, HTTPoison.Error.t}

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

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 as a binary string or char list
headers - HTTP headers as an orddict (e.g., `[{:Accept, "application/json"}]`)
options - orddict of options

Options:

:timeout - the timeout (in milliseconds) of the request
:stream_to - a PID to stream the response to
:proxy - a proxy to be used for the request; it can by a regular url or a {Host, Proxy} tuple

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"}])

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

(function) # ↑

Specs:

request!(atom, binary, binary, headers, [{atom, any}]) :: 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.

start()

(function) # ↑

Starts HTTPoison and its dependencies.

start(type, args)

(function) # ↑

Callback implementation of :application.start/2.