Dnsimple.Client (dnsimple v6.0.1)

Summary

Types

body()

headers()

t()

Functions

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

Issues a DELETE request to the given url.

empty_body()

Returns the representation of an empty body in a request.

execute(client, method, url, body \\ "", all_options \\ [])

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

Issues a GET request to the given url.

new_from_env()

Initializes a new client from the application environment.

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

Issues a PATCH request to the given url.

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

Issues a POST request to the given url.

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

Issues a PUT request to the given url.

versioned(path)

Prepends the correct API version to path.

Types

body()

@type body() ::
  binary() | {:form, [{atom(), any()}]} | {:file, binary()} | Keyword.t()

headers()

@type headers() :: [{binary(), binary()}] | %{required(binary()) => binary()}

t()

@type t() :: %Dnsimple.Client{
  access_token: String.t(),
  base_url: String.t(),
  user_agent: String.t()
}

Functions

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

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

Issues a DELETE request to the given url.

empty_body()

@spec empty_body() :: nil

Returns the representation of an empty body in a request.

Examples

iex> Dnsimple.Client.empty_body() nil

execute(client, method, url, body \\ "", all_options \\ [])

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

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

Issues a GET request to the given url.

new_from_env()

@spec new_from_env() :: t()

Initializes a new client from the application environment.

Examples

client = Dnsimple.Client.new_from_env()

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

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

Issues a PATCH request to the given url.

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

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

Issues a POST request to the given url.

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

@spec put(t(), binary(), nil | body(), Keyword.t()) ::
  {:ok | :error, HTTPoison.Response.t() | HTTPoison.AsyncResponse.t()}

Issues a PUT request to the given url.

versioned(path)

@spec versioned(String.t()) :: String.t()

Prepends the correct API version to path.

Examples

iex> Dnsimple.Client.versioned "/whoami"
"/v2/whoami"