• API сервиса OttPlayer предоставляет возможность автоматического создания и подключения пользователей к плейлисту провайдера.

    Провайдер плейлиста - сервис, предоставляющий своим пользователям доступ к видеоконтенту путём выдачи ссылок на видеопоток, оформленный в виде плейлиста.

    После подачи заявки на регистрацию провайдера плейлиста и получения подтверждения администратора нашего сервиса провайдеру предоставляется адрес запроса к API.

    Для автоматического создания аккаунта провайдер делает запрос по адресу API, в котором передаёт всю необходимую информацию (см. раздел "ЗАПРОС К API"). В сервисе OttPlayer создаётся аккаунт пользователя и плейлист, переданный провайдером в запросе.

    В ответ на запрос API возвращает логин и пароль атоматически созданного аккаунта, которые провайдер может передать своему пользователю для авторизации в приложении и кабинете на сайте OttPlayer.

    Пользователь провайдера авторизуется в приложении OttPlayer, установленном на его устройстве, и, после небольшой настройки (указать название устройства), получает возможность просмотра плейлиста провайдера.

    С полученной парой логин/пароль пользователь также может авторизоваться в аккаунте OttPlayer для управления, сортировки, удаления каналов.

    Более подробно каждый шаг использования API описывается в соответствующем разделе на этой странице.

  • Для регистрации провайдера плейлиста и получения доступа к API сервиса OttPlayer заполните форму ниже и нажмите кнопку "ОТПРАВИТЬ".

    все поля обязательны к заполнению
    поле значение
    контактное имя Имя представителя провайдера плейлиста. Используется для обращения.
    url сервиса Адрес сайта сервиса в формате http(s)://site.net
    email аккаунта OttPlayer Регистрационный адрес электронной почты существующего аккаунта OttPlayer, от имени которого будут выполняться запросы к API. Также этот адрес будет использоваться для оповещений о событиях и изменениях в использовании API.
    Внимание! Доменная часть адреса электронной почты должна совпадать с доменом в URL сервиса.
    Регистрация провайдера плейлиста

  • После проверки данных, предоставленных в заявке на регистрацию провайдера, и подтверждения администратора в аккаунте пользователя OttPlayer, который был указан в заявке, появится новый пункт меню - Плейлист-провайдер. На этой странице будут отображаться данные провайдера плейлиста и статус подключения к API - администратор имеет право отключить доступ к API OttPlayer при обнаружении неправомерного использования сервиса.

  • Запрос к API на автоматическое создание аккаунта должен иметь следующие параметры:

    параметр значение
    метод запроса POST
    заголовок запроса (headers) 'Content-Type: multipart/form-data;'
    Поля запроса:
    username [email protected] - регистрационный адрес аккаунта OttPlayer, указанный в заявке на подключение провайдера к API OttPlayer (см. РЕГИСТРАЦИЯ ПРОВАЙДЕРА)
    password greatPassword - пароль к аккаунту OttPlayer, указанный в заявке на подключение
    data JSON-строка с данными плейлиста
    Структура JSON-строки поля data:
    name (строка) 'GreatPlaylist' - название плейлиста
    update_url (строка) 'http://service.net/link_to_playlist' - URL ссылки автообновления плейлиста
    groups (массив обьектов) каналы плейлиста, сруппированные по группам (см. пример). В случае отсутствия группировки каналов плейлиста провайдера, все каналы должны быть в группе "unsorted"
    Пример JSON-строки поля 'data'

  • После успешной обработки запроса и создания аккаунта и плейлиста, предоставленного провайдером, API возвращает JSON-строку с данными созданного аккаунта.
    Пример JSON-строки ответа API

    Данные ответа API означают, что создан аккаунт с именем "8681-AG4O-Q09C-9DXO" в сервисе OttPlayer и плейлист, доступный для этого аккаунта. Для авторизации этого аккаунта в приложении OttPlayer или на сайте https://ottplayer.tv необходимо использовать логин "8681-AG4O-Q09C-9DXO" и пароль "G7AFY272".

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

    Любой другой ответ API считается ошибкой создания аккаунта и плейлиста.

  • После запуска плеера OttPlayer на устройстве пользователя и успешной авторизации (указать пару логин-пароль, предоставленный API через провайдера плейлиста), пользователь получает возможность воспроизвести содержимое плейлиста провайдера.

  • При первой авторизации на сайте сервиса OttPlayer с учётными данными (пара логин-пароль), предоставленными API через провайдера, производится проверка на наличие у пользователя существовавшего ранее аккаунта в сервисе OttPlayer. Если пользователь не регистрировался ранее, он может пропустить этот шаг.

    Если пользователь уже имеет аккаунт OttPlayer с реально существующим адресом электронной почты, ему будет предоставлена возможность присоединить плейлист, созданный через API, к уже существующему аккаунту. Для этого необходимо указать логин-пароль уже имеющегося аккаунта OttPlayer. После успешной проверки пары логин-пароль существующего аккаунта все устройства и плейлист, которые соответствовали автоматически созданному аккаунту, будут присоединены к ранее существовавшему, а сам автоматически созданный аккаунт будет удалён. Поэтому, после процедуры обьединения аккаунтов, для просмотра плейлиста провайдера необходимо использовать логин-пароль ранее существовавшего аккаунта OttPlayer.