#5 – Consulta de dados na Twitch®

Documentação Twitch:

A Twitch possui uma documentação própria para desenvolvedores que detalha todas as informações de autorização, acesso, requisições, etc. Deixarei o link embaixo:

API Twitch

Para conseguir acessar as requisições, é necessário estar de acordo com as definições exigidas pela empresa com relação à sua configuração de conta. Isso para tornar o ambiente de desenvolvimento mais seguro para os usuários também. Ao estar de acordo, você consegue realizar as requisições dos dados públicos apenas, mas que abrangem uma boa fonte de dados.

Não detalharei à fundo o passo a passo da configuração de conta pois, esse processo pode alterar à qualquer momento e envolve muitas informações pessoais. Mas é só seguindo as orientações da Twitch.

No caso, ao ter a configuração de conta aprovado, você finalmente terá o seu Client_ID e o Client_secret. Esse ID será seu identificador nas consultas APIs da Twitch e o secret é tipo uma senha. Guarde-as e por favor, NUNCA divulgar.

Token de Acesso:

Tendo o Client_ID e o Client_secret, será necessário obter o Token de acesso para ser utilizado nas requisições da API. No caso, o tipo de autenticação a ser utilizada dependerá da finalidade da requisição. Tudo isso pode ser seguido conforme a documentação da empresa abaixo:

Link Token

Apenas para reforçar que esses tokens de acesso são únicos, vinculados ao Client_ID e possuem validade. E de novo, NUNCA divulgar.

Portanto, em resumo, as informações a serem utilizadas em cada consulta da API da Twitch será necessária incluir as duas informações abaixo:

Authorization: Bearer <Token de acesso aqui>

Client-ID: <Client_ID aqui>

Exemplo de solicitação:

Para realizar uma solicitação, utilizei para o projeto o Power Automate (Invocar um serviço Web), mas utilizei o Postman para testes, no qual detalharei no próximo post.

A solicitação principal que utilizei como base de dados do projeto foi o Top 100 Streams diário, ou seja, os 100 Streams mais populares naquele momento. A documentação para essa requisição em específico:

Link Top Games

Para requisitar essa lista, utilizei a seguinte URL:

https://api.twitch.tv/helix/games/top

Como padrão, a solicitação retorna apenas os 20 primeiros resultados. Para alterar para outro número, apenas alterar o Query Param (parâmetros) para First N (a quantidade que deseja). Automaticamente o link alterará para (utilizando 100 como exemplo):

https://api.twitch.tv/helix/games/top?first=100

O resultado retornado em JSON será algo como: (aqui o retorno é de apenas 10):

{
    "data": [
        {
            "id": "509658",
            "name": "Just Chatting",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/509658-{width}x{height}.jpg>",
            "igdb_id": ""
        },
        {
            "id": "21779",
            "name": "League of Legends",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/21779-{width}x{height}.jpg>",
            "igdb_id": "115"
        },
        {
            "id": "32399",
            "name": "Counter-Strike",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/32399-{width}x{height}.jpg>",
            "igdb_id": ""
        },
        {
            "id": "32982",
            "name": "Grand Theft Auto V",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/32982_IGDB-{width}x{height}.jpg>",
            "igdb_id": "1020"
        },
        {
            "id": "1630435000",
            "name": "Cloverpit",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/1630435000_IGDB-{width}x{height}.jpg>",
            "igdb_id": "338902"
        },
        {
            "id": "516575",
            "name": "VALORANT",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/516575-{width}x{height}.jpg>",
            "igdb_id": "126459"
        },
        {
            "id": "29595",
            "name": "Dota 2",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/29595-{width}x{height}.jpg>",
            "igdb_id": ""
        },
        {
            "id": "624536948",
            "name": "EA Sports FC 26",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/624536948_IGDB-{width}x{height}.jpg>",
            "igdb_id": "353848"
        },
        {
            "id": "509672",
            "name": "IRL",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/509672-{width}x{height}.jpg>",
            "igdb_id": ""
        },
        {
            "id": "2012789438",
            "name": "Call of Duty: Black Ops 7",
            "box_art_url": "<https://static-cdn.jtvnw.net/ttv-boxart/2012789438_IGDB-{width}x{height}.jpg>",
            "igdb_id": "348220"
        }
    ],
    "pagination": {
        "cursor": "eyJzIjoxMCwiZCI6ZmFsc2UsInQiOnRydWV9"
    }
}

Nessa resposta JSON, já podemos identificar que:

• Os resultados estão listados dentro de “data”;
• Cada resultado tem como padrão as informações de “id”, “name”, “box_art_url” e “igdb_id”;
• Nem todos os streams possuem “igdb_id”.

A partir dessas informações que precisamos adequar para o nosso arquivo “banco de dados”, que no caso, escolhi o arquivo tipo .csv mesmo. Além de pegar a data que foi coletada as informações e um index de 1 a 100 para sabermos a ordenação de cada dia.

O próximo post será detalhado um pouco mais dos testes de requisições feitos no Postman.

Nos vemos no próximo Post!