Struct twitch_oauth2::AppAccessToken

pub struct AppAccessToken { /* fields omitted */ }

An App Access Token from the OAuth client credentials flow

Implementations

impl AppAccessToken

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

Assemble token without checks.

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

Assemble token and validate it. Retrieves client_id and scopes.

pub async fn get_app_access_token<RE, C, F>(
    http_client: C,
    client_id: ClientId,
    client_secret: ClientSecret,
    scopes: Vec<Scope>
) -> Result<AppAccessToken, TokenError<RE>> where
    RE: Error + Send + Sync + 'static,
    C: Fn(HttpRequest) -> F,
    F: Future<Output = Result<HttpResponse, RE>>, 

Generate app access token via OAuth client credentials flow

Trait Implementations

impl Clone for AppAccessToken

fn clone(&self) -> AppAccessToken

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AppAccessToken

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

Formats the value using the given formatter.

impl TwitchToken for AppAccessToken

fn client_id(&self) -> &ClientId

Get the client-id. 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