Twitch API - Как получить текущую трансляцию по названию канала? (PHP)

Mex-Vision · 4 Ноя 2021

Всем привет, пытаюсь сделать небольшой модуль для трансляций, а именно, мониторинг каналов и отображения активных трансляций на них. С YouTube все успешно получилось, а вот Twitch дает мне под зад уже пол дня.

Я постоянно натыкаюсь на отсутcвие авторизации, пытался разобраться в документации, но всё безуспешно, так как примеров на PHP практически нет, а если и есть, то работают они со старым API которое уже не работает (kraken).

Мне необходимо получать:
- Название канала
- Аватарку стримера (канала)
- Статус текущей трансляции
- Название текущей трансляции

Буду очень благодарен за небольшой пример использования Twitch API.

òbi · 4 Ноя 2021

Mex-Vision, вот небольшой пример

PHP:

<?php

ini_set( 'display_errors', '1' );
error_reporting( E_ALL );

class TwitchApiV5
{
    const KRAKEN_URL    = 'https://api.twitch.tv/kraken';
    // регистрируем приложение и получаем ключи тут - https://dev.twitch.tv/console/apps/
    const CLIENT_ID        = 'xxxxx';
    const CLIENT_SECRET    = 'xxxx';
    
    private $curl = null;
    
    public function __construct()
    {
        $this->curl  = curl_init();
    }
    
    /**
     * @link https://dev.twitch.tv/docs/v5/reference/streams/#get-live-streams
     */
    public function getStreams( array $arr = null )
    {
        $parameters = $this->_parseArray( $arr );

        $url = self::KRAKEN_URL . '/streams' . $parameters;
        
        curl_setopt_array( $this->curl, [
                CURLOPT_URL            => $url,
                CURLOPT_RETURNTRANSFER => 1,
                CURLOPT_TIMEOUT        => 1,
                CURLOPT_HTTPHEADER     => [
                    'Accept: application/vnd.twitchtv.v5+json',
                    'Client-ID: ' . self::CLIENT_ID
                ]
            ]
        );

        return json_decode( curl_exec( $this->curl ), true );
    }
    
    private function _parseArray( array $arr = null )
    {
        $parameters = '';

        if ( $arr )
        {
            $parameters = '?';
            $lastValue = end( $arr );
            $endKey = key( $arr );
            foreach ( $arr as $key => $value )
            {
                $parameters .= $key . '=' . $value . ( $key == $endKey ? '' : '&' );
            }
        }

        return $parameters;
    }
    
    public function __destruct()
    {
        if ( !is_null( $this->curl ) )
        {
            curl_close( $this->curl );
        }
    }
}

$api = new TwitchApiV5();

echo '<pre>';
print_r( $api->getStreams( [ 'limit' => 100, 'offset' => 0, 'game' => rawurlencode( 'Lineage 2' ) ] ) );
echo '</pre>';

результат

Код:

достаем нужные данные из полученного массива // profit!

Mex-Vision · 4 Ноя 2021

òbi написал(а):

Mex-Vision, вот небольшой пример

PHP:

<?php

ini_set( 'display_errors', '1' );
error_reporting( E_ALL );

class TwitchApiV5
{
    const KRAKEN_URL    = 'https://api.twitch.tv/kraken';
    // регистрируем приложение и получаем ключи тут - https://dev.twitch.tv/console/apps/
    const CLIENT_ID        = 'xxxxx';
    const CLIENT_SECRET    = 'xxxx';
   
    private $curl = null;
   
    public function __construct()
    {
        $this->curl  = curl_init();
    }
   
    /**
     * @link https://dev.twitch.tv/docs/v5/reference/streams/#get-live-streams
     */
    public function getStreams( array $arr = null )
    {
        $parameters = $this->_parseArray( $arr );

        $url = self::KRAKEN_URL . '/streams' . $parameters;
       
        curl_setopt_array( $this->curl, [
                CURLOPT_URL            => $url,
                CURLOPT_RETURNTRANSFER => 1,
                CURLOPT_TIMEOUT        => 1,
                CURLOPT_HTTPHEADER     => [
                    'Accept: application/vnd.twitchtv.v5+json',
                    'Client-ID: ' . self::CLIENT_ID
                ]
            ]
        );

        return json_decode( curl_exec( $this->curl ), true );
    }
   
    private function _parseArray( array $arr = null )
    {
        $parameters = '';

        if ( $arr )
        {
            $parameters = '?';
            $lastValue = end( $arr );
            $endKey = key( $arr );
            foreach ( $arr as $key => $value )
            {
                $parameters .= $key . '=' . $value . ( $key == $endKey ? '' : '&' );
            }
        }

        return $parameters;
    }
   
    public function __destruct()
    {
        if ( !is_null( $this->curl ) )
        {
            curl_close( $this->curl );
        }
    }
}

$api = new TwitchApiV5();

echo '<pre>';
print_r( $api->getStreams( [ 'limit' => 100, 'offset' => 0, 'game' => rawurlencode( 'Lineage 2' ) ] ) );
echo '</pre>';

результат

Код:

достаем нужные данные из полученного массива // profit!

Спасибо за пример, попробую и отпишусь. Вопрос: kraken вообще работает сейчас? А то у меня при попытке запроса к нему выдавало что-то в духе "устаревший api иди зубри документацию оО".

òbi · 4 Ноя 2021

Mex-Vision, скорее всего передается не верный заголовок (не та версия апи или еще что)

Код:

Accept: application/vnd.twitchtv.v5+json

вот метод получения данных по айди канала для ранее представленного класса

PHP:

class TwitchApiV5
{
     ...
     /**
     * @link https://dev.twitch.tv/docs/v5/reference/streams/#get-stream-by-user
     */
    public function getStream( $channel = '', array $arr = null )
    {
        $parameters = $this->_parseArray( $arr );
        
        $url = self::KRAKEN_URL . '/streams/' . $channel . $parameters;

        curl_setopt_array( $this->curl, [
                CURLOPT_URL            => $url,
                CURLOPT_RETURNTRANSFER => 1,
                CURLOPT_TIMEOUT        => 1,
                CURLOPT_HTTPHEADER     => [
                    'Accept: application/vnd.twitchtv.v5+json',
                    'Client-ID: ' . self::CLIENT_ID
                ]
            ]
        );
        
        return json_decode( curl_exec( $this->curl ), true );
    }
    ...
}

$api = new TwitchApiV5();

echo '<pre>';
print_r( $api->getStream( '729604925' ) );
echo '</pre>';

результат

Код:

представленные результаты с только что сделанных запросов этим скриптом, так что кракен работает

Mex-Vision · 4 Ноя 2021

òbi написал(а):

Mex-Vision, скорее всего передается не верный заголовок (не та версия апи или еще что)

Код:

Accept: application/vnd.twitchtv.v5+json

вот метод получения данных по айди канала для ранее представленного класса

PHP:

class TwitchApiV5
{
     ...
     /**
     * @link https://dev.twitch.tv/docs/v5/reference/streams/#get-stream-by-user
     */
    public function getStream( $channel = '', array $arr = null )
    {
        $parameters = $this->_parseArray( $arr );
       
        $url = self::KRAKEN_URL . '/streams/' . $channel . $parameters;

        curl_setopt_array( $this->curl, [
                CURLOPT_URL            => $url,
                CURLOPT_RETURNTRANSFER => 1,
                CURLOPT_TIMEOUT        => 1,
                CURLOPT_HTTPHEADER     => [
                    'Accept: application/vnd.twitchtv.v5+json',
                    'Client-ID: ' . self::CLIENT_ID
                ]
            ]
        );
       
        return json_decode( curl_exec( $this->curl ), true );
    }
    ...
}

$api = new TwitchApiV5();

echo '<pre>';
print_r( $api->getStream( '729604925' ) );
echo '</pre>';

результат

Код:

представленные результаты с только что сделанных запросов этим скриптом, так что кракен работает

К сожалению нет(

The v5 API is deprecated and will be shutdown on February 28, 2022. Applications that have not accessed v5 before July 15, 2021 no longer have access to v5. For more information on the v5 API shutdown plan, see

Вы не можете просматривать ссылку пожалуйста воспользуйтесь следующими ссылками Вход или Регистрация

and the Twitch API documentation at

Вы не можете просматривать ссылку пожалуйста воспользуйтесь следующими ссылками Вход или Регистрация

.

òbi · 4 Ноя 2021

Mex-Vision,

ну да, помечен устаревшим
но работает же еще, и будет работать до 28 февраля 2022. Потом придется переписывать)

Mex-Vision · 4 Ноя 2021

òbi написал(а):
Mex-Vision, ну да, помечен устаревшим
но работает же еще, и будет работать до 28 февраля 2022. Потом придется переписывать)

Он работает только у тех, кто создал свое "приложение" до определенного времени (July 15, 2021). Так что пошел я зубрить API=)

òbi · 4 Ноя 2021

Mex-Vision написал(а):
Он работает только у тех, кто создал свое "приложение" до определенного времени (July 15, 2021). Так что пошел я зубрить API=)

Пользуйся, мне не жалко))

Скрытое содержимое для пользователя(ей): Mex-Vision

Mex-Vision · 4 Ноя 2021

òbi написал(а):
Пользуйся, мне не жалко))
*** Скрытый текст не может быть процитирован. ***

Спасибо, но я уже решил проблему, тесты заработали, сейчас доведу код до ума и выложу сюда, возможно кому-то пригодится.

Mex-Vision · 4 Ноя 2021

Решил проблему благодаря ответам в данной теме, Google Translate и документации Twitch Api.

Алгоритм действий для таких чайников как я:
1) Регистрируем приложение -

Вы не можете просматривать ссылку пожалуйста воспользуйтесь следующими ссылками Вход или Регистрация

2) CLIENT_ID - Перейдите в свое приложение, там будет поле "Идентификатор клиента" - это он и есть.
3) CLIENT_SECRET - Перейдите в свое приложение, там будет кнопка "Новый секретный код", после нажатие вы его увидите.
4) Метод _getAccessToken получает токкен для авторизации, который в дальнейшем используется в заголовке запроса.

Документация для тех кто будет допиливать код:

Вы не можете просматривать ссылку пожалуйста воспользуйтесь следующими ссылками Вход или Регистрация

Примитивный класс для работы с Twitch Api.

PHP:

class TwitchApi
{
    const HELIX_URL    = 'https://api.twitch.tv/helix';

    // Регистрируем приложение и получаем ключи тут - https://dev.twitch.tv/console/apps/
    const CLIENT_ID        = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
    const CLIENT_SECRET    = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';

    private $curl = null;

    public function __construct()
    {
        $this->curl = curl_init();
    }

    /**
     * @link https://dev.twitch.tv/docs/api/reference#get-streams
     */

    public function getStreams( array $arr = null )
    {
        $url = self::HELIX_URL . '/streams?' . http_build_query($arr,"", null, PHP_QUERY_RFC3986);
        return $this->_curl_exec($url);
    }

    /**
     * @link https://dev.twitch.tv/docs/api/reference#get-channel-information
     */

    public function getChannel(array $arr = null)
    {
        $url = self::HELIX_URL . '/channels?' . http_build_query($arr,"", null, PHP_QUERY_RFC3986);
        return $this->_curl_exec($url);
    }
  
    private function _curl_exec(string $url)
    {
        curl_setopt_array( $this->curl, [
                CURLOPT_URL            => $url,
                CURLOPT_RETURNTRANSFER => 1,
                CURLOPT_TIMEOUT        => 1,
                CURLOPT_HTTPHEADER     => [
                    'Authorization: Bearer ' . $this->_getAccessToken(),
                    'Client-Id: ' . self::CLIENT_ID
                ]
            ]
        );

        return json_decode( curl_exec( $this->curl ), true );
    }

    private function _getAccessToken()
    {
        $url = 'https://id.twitch.tv/oauth2/token';
        $data = array('client_id' => self::CLIENT_ID, 'client_secret' => self::CLIENT_SECRET, 'grant_type' => 'client_credentials');

        $options = array(
            'http' => array(
                'header' => "Content-type: application/x-www-form-urlencoded\r\n",
                'method' => 'POST',
                'content' => http_build_query($data)
            )
        );

        $context = stream_context_create($options);
        $result = json_decode(file_get_contents($url, false, $context), true );

        return $result['access_token'];
    }

    public function __destruct()
    {
        if(!is_null($this->curl))
            curl_close($this->curl);
    }
}

Результат выполнения метода getStreams(['user_login' => 'weplaycsgo_ru']):

PS: Спасибо

òbi

=)

Desquire · 5 Ноя 2021

По топу что вы писали, похоже на oauth
Там должен быть лайфтайм токена, чтобы вы каждый раз не получали аксес токен ( но это не точно)

Mex-Vision · 5 Ноя 2021

Desquire написал(а):
По топу что вы писали, похоже на oauth
Там должен быть лайфтайм токена, чтобы вы каждый раз не получали аксес токен ( но это не точно)

Да, он есть. Можно доработать код конечно же)

Twitch API - Как получить текущую трансляцию по названию канала? (PHP)

Дополнительные настройки

Mex-Vision

Бессмертный

òbi

-Wan Kenobi

Mex-Vision

Бессмертный

òbi

-Wan Kenobi

Mex-Vision

Бессмертный

òbi

-Wan Kenobi

Mex-Vision

Бессмертный

òbi

-Wan Kenobi

Mex-Vision

Бессмертный

Mex-Vision

Бессмертный

òbi

Desquire

Гений мысли

Mex-Vision

Бессмертный

Twitch API - Как получить текущую трансляцию по названию канала? (PHP)

Бессмертный

-Wan Kenobi

Бессмертный

-Wan Kenobi

Бессмертный

-Wan Kenobi

Бессмертный

-Wan Kenobi

Бессмертный

Бессмертный

òbi​

Гений мысли

Бессмертный

òbi