twitch_oauth_token 4.4.0

Type-safe Twitch OAuth 2.0 authentication library with CSRF protection and full scope support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

use std::str::FromStr;

use asknothingx2_util::api::{AuthScheme, IntoRequestBuilder, Method};
use reqwest::{Client, RequestBuilder, header::AUTHORIZATION};

use crate::{AccessToken, Error, ValidateUrl, tokens::TokenInfo};

/// <https://dev.twitch.tv/docs/authentication/validate-tokens/>
pub async fn validate_access_token(access_token: &AccessToken) -> Result<TokenInfo, Error> {
    crate::oauth::json(
        crate::client::get(),
        ValidateRequest::new(
            access_token,
            &ValidateUrl::from_str(crate::oauth::VALIDATE_URL).unwrap(),
        ),
    )
    .await
}

/// <https://dev.twitch.tv/docs/authentication/validate-tokens/>
#[derive(Debug)]
pub struct ValidateRequest<'a> {
    access_token: &'a AccessToken,
    validate_url: &'a ValidateUrl,
}

impl<'a> ValidateRequest<'a> {
    pub fn new(access_token: &'a AccessToken, validate_url: &'a ValidateUrl) -> Self {
        Self {
            access_token,
            validate_url,
        }
    }
}

#[allow(dead_code)]
#[cfg(feature = "test")]
impl<'a> ValidateRequest<'a> {
    pub fn with_validate_url(mut self, url: &'a ValidateUrl) -> Self {
        self.validate_url = url;
        self
    }

    pub async fn send(self, client: &reqwest::Client) -> Result<TokenInfo, Error> {
        crate::oauth::json(client, self).await
    }
}

impl IntoRequestBuilder for ValidateRequest<'_> {
    type Error = Error;

    fn into_request_builder(self, client: &Client) -> Result<RequestBuilder, Error> {
        Ok(client
            .request(Method::GET, self.validate_url.as_str())
            .header(
                AUTHORIZATION,
                AuthScheme::custom("OAuth", self.access_token.secret()).to_header_value()?,
            ))
    }
}