Struct twitch_oauth2::UserToken

pub struct UserToken {
    pub access_token: AccessToken,
    pub refresh_token: Option<RefreshToken>,
    // some fields omitted
}

An User Token from the OAuth implicit code flow or OAuth authorization code flow

Fields

access_token: AccessToken

The access token used to authenticate requests with

refresh_token: Option<RefreshToken>

The refresh token used to extend the life of this user token

Implementations

impl UserToken

pub fn from_existing_unchecked(
    access_token: impl Into<AccessToken>,
    refresh_token: impl Into<Option<RefreshToken>>,
    client_id: impl Into<ClientId>,
    client_secret: impl Into<Option<ClientSecret>>,
    login: Option<String>,
    scopes: Option<Vec<Scope>>
) -> UserToken

Assemble token without checks.

pub async fn from_existing<RE, C, F>(
    http_client: C,
    access_token: AccessToken,
    refresh_token: impl Into<Option<RefreshToken>>,
    client_secret: impl Into<Option<ClientSecret>>
) -> Result<UserToken, ValidationError<RE>> where
    RE: Error + Send + Sync + 'static,
    C: FnOnce(HttpRequest) -> F,
    F: Future<Output = Result<HttpResponse, RE>>, 

Assemble token and validate it. Retrieves login, client_id and scopes

pub fn builder(
    client_id: ClientId,
    client_secret: ClientSecret,
    redirect_url: RedirectUrl
) -> Result<UserTokenBuilder, ParseError>

Create a UserTokenBuilder to get a token with the OAuth Authorization Code

Trait Implementations

impl Clone for UserToken

fn clone(&self) -> UserToken

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UserToken

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl TwitchToken for UserToken

fn client_id(&self) -> &ClientId

Client ID associated with the token. Twitch requires this in all helix API calls

fn token(&self) -> &AccessToken

Get the AccessToken for authenticating

fn login(&self) -> Option<&str>

Get the username associated to this token

fn refresh_token<'life0, 'async_trait, RE, C, F>(
    &'life0 mut self,
    http_client: C
) -> Pin<Box<dyn Future<Output = Result<(), RefreshTokenError<RE>>> + 'async_trait>> where
    RE: Error + Send + Sync + 'static,
    C: FnOnce(HttpRequest) -> F,
    F: Future<Output = Result<HttpResponse, RE>>,
    RE: 'async_trait,
    C: 'async_trait,
    F: 'async_trait,
    'life0: 'async_trait,
    Self: 'async_trait, 

Refresh this token, changing the token to a newer one

fn expires(&self) -> Option<Instant>

Get instant when token will expire.

fn scopes(&self) -> Option<&[Scope]>

Retrieve scopes attached to the token

#[must_use]fn validate_token<'life0, 'async_trait, RE, C, F>(
    &'life0 self,
    http_client: C
) -> Pin<Box<dyn Future<Output = Result<ValidatedToken, ValidationError<RE>>> + 'async_trait>> where
    RE: Error + Send + Sync + 'static,
    C: FnOnce(HttpRequest) -> F,
    F: Future<Output = Result<HttpResponse, RE>>,
    RE: 'async_trait,
    C: 'async_trait,
    F: 'async_trait,
    'life0: 'async_trait,
    Self: 'async_trait, 

Validate this token. Should be checked on regularly, according to https://dev.twitch.tv/docs/authentication#validating-requests

#[must_use]fn revoke_token<'async_trait, RE, C, F>(
    self,
    http_client: C
) -> Pin<Box<dyn Future<Output = Result<(), RevokeTokenError<RE>>> + 'async_trait>> where
    Self: Sized,
    RE: Error + Send + Sync + 'static,
    C: FnOnce(HttpRequest) -> F,
    F: Future<Output = Result<HttpResponse, RE>>,
    RE: 'async_trait,
    C: 'async_trait,
    F: 'async_trait,
    Self: 'async_trait, 

Revoke the token. See https://dev.twitch.tv/docs/authentication#revoking-access-tokens