Twtich-API-Token-Refresher

This is a Python program based on the Flask architecture for refreshing the Twitch API tokens.

install & Setup

You need to create the Twitch application first

1. Go to the Twitch Developer Console and create a new application

2. OAuth Redirect URL fill in: https://localhost/twitch-auth-callback

3. Write down the Client ID and Client Secret will be used later.

Docker

The ssl folder must be mounted to mount, and The certificate must be named as follows:

• server.crt

• server.key

Example using docker-compose:

version: "3.9"

services:
  TwitchAPI:
    image: "ghcr.io/interfacegui/twitch-api-token-refresher:latest"
    environment:
      ClientID: "YOUR Twitch APP ID"
      ClientSecret: "YOUR Twitch APP SECRET"
      scope: "channel:read:redemptions,user:read:email,channel:read:subscriptions"
    volumes:
      - /home/ubuntu/ssl:/app/ssl
    ports:
      - "3000:3000"

How to use

• Go to /loginendpoint to Get Access Token and Refresh Token

• Refresh the token using the /refresh endpoint:

Refresh Token

  await fetch('https://0.0.0.0:3000/refresh',{
      method: "POST", headers: {'Origin':'*','content-type': 'application/json'},
      body:JSON.stringify({"refresh_token": 'RefreshToken'})
  })
  .then(function(response) {
    return response.json();
  })
  .then(function(myJson) {
    console.log(myJson);
  });

Example for the streamelement widget

Validate and refresh the token

window.addEventListener('onWidgetLoad', async function (obj) {
    await TwitchAPI_validate()
});

const twitchOAuthToken = "{{Twitch_access_token}}"
const TwitchRefreshToken = "{{Twitch_refresh_token}}"

async function TwitchAPI_validate(){
    
    //Test the access token. If the token expires, twitch will return 401.
    const response = await fetch('https://id.twitch.tv/oauth2/validate',{
        method: "GET",
        headers: {
            Authorization: `Bearer ${twitchOAuthToken}`
        }
    })
    
    if ( response.status == 401){
        console.log('invalid access token')
        console.log('Getting new token...')
        
        const newtoken = await fetch('https://0.0.0.0:3000/refresh',{
            method: "POST", headers: {'Origin':'*','content-type': 'application/json'},
            body:JSON.stringify({"refresh_token":TwitchRefreshToken})
        })

        if ( newtoken.status != 200){return false}
        
      	let respData = await newtoken.json();
        console.log(respData);
        
        //Update widget Field
        SE_API.setField('Twitch_access_token', respData['access_token']);
    }
    return true
}

Use the twitch api

await fetch('https://api.twitch.tv/helix/users',{
    method: "GET",
    headers: {
        Authorization: `Bearer ${twitchOAuthToken}`,
        'Client-Id': '---Client id here---'
    }
})
.then((response) => {
    return response.json()
})
.catch((error) => {
    console.log(`Error: ${error}`);
})

fields.json

{
    "Twitch_access_token": {
        "type": "text",
        "label": "Twitch Access Token",
        "value": "",
        "group": "Twitch Settings"
    },
    "Twitch_refresh_token": {
        "type": "text",
        "label": "Twitch Refresh Token",
        "value": "",
        "group": "Twitch Settings"
    }
}