OAuth 2.0 access token response.
A cacheable struct holding the parsed token data from a platform's token
endpoint. Host apps can store this and reuse it across contexts via
Ltix.OAuth.Client.from_access_token/2.
Examples
iex> {:ok, token} = Ltix.OAuth.AccessToken.from_response(
...> %{
...> "access_token" => "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9",
...> "token_type" => "Bearer",
...> "expires_in" => 3600,
...> "scope" => "https://purl.imsglobal.org/spec/lti-nrps/scope/contextmembership.readonly"
...> },
...> now: ~U[2025-01-01 00:00:00Z]
...> )
iex> token.access_token
"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9"
iex> token.token_type
"bearer"
iex> token.granted_scopes
["https://purl.imsglobal.org/spec/lti-nrps/scope/contextmembership.readonly"]
iex> token.expires_at
~U[2025-01-01 01:00:00Z]Summary
Functions
Parse an access token from a token endpoint response body.
Types
@type t() :: %Ltix.OAuth.AccessToken{ access_token: String.t(), expires_at: DateTime.t(), granted_scopes: [String.t()], token_type: String.t() }
Functions
@spec from_response( map(), keyword() ) :: {:ok, t()} | {:error, Exception.t()}
Parse an access token from a token endpoint response body.
Options
:requested_scopes- list of scope strings that were requested, used as fallback when the response omits"scope".:now- override current time (default:DateTime.utc_now/0).