ExDisco.Auth.Authorization (ex_disco v0.1.0)

The single public-facing authentication type for the Discogs API.

Use the factory functions to create an Authorization and pass it as the first argument to any function that requires authentication.

Personal Token

token = ExDisco.Config.user_token()
auth = ExDisco.Auth.Authorization.for_user_token(token)

auth
|> ExDisco.Users.get_identity()

{:ok, credentials} = ExDisco.Auth.access_token(request_token, verifier)

credentials
|> ExDisco.Users.get_identity()

t()

Creates an Authorization from OAuth credentials.

Creates an Authorization from a personal token string.

@type t() :: %ExDisco.Auth.Authorization{
  credentials: term(),
  type: :user_token | :oauth
}

@spec for_oauth(String.t(), String.t(), String.t(), String.t()) :: t()

Creates an Authorization from OAuth credentials.

iex> ExDisco.Auth.Authorization.for_oauth("key", "secret", "token", "token_secret")
%ExDisco.Auth.Authorization{type: :oauth, credentials: %{...}}

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

Creates an Authorization from a personal token string.

iex> ExDisco.Auth.Authorization.for_user_token("my_token")
%ExDisco.Auth.Authorization{type: :user_token, credentials: "my_token"}