API VOD — различия между версиями
Материал из TVPlayer.FM
Admin (обсуждение | вклад) (→Описание метода) |
Admin (обсуждение | вклад) (→Формат запроса) |
||
Строка 49: | Строка 49: | ||
===Формат запроса=== | ===Формат запроса=== | ||
− | <pre>http://api.tvplayer.fm/<API_VERSION>/<FORMAT_TYPE>/vod?token=<TOKEN_ID>&id=<VOD_ID></pre> | + | <pre>http://api.tvplayer.fm/<API_VERSION>/<FORMAT_TYPE>/vod?token=<TOKEN_ID>&id=<VOD_ID>&protected=<PIN_CODE></pre> |
+ | :Необязательные параметры [optional]: | ||
+ | ::'''protected''' - PIN CODE (код родительского контроля) | ||
:Обязательные параметры: | :Обязательные параметры: | ||
::'''id''' - ID фильма из метода vods. | ::'''id''' - ID фильма из метода vods. |
Текущая версия на 15:26, 4 июля 2020
Содержание
API VOD
[vod_genres] Список категорий VOD
Описание метода
Возвращает полный список доступных для клиента VOD категорий.
Формат запроса
http://api.tvplayer.fm/<API_VERSION>/<FORMAT_TYPE>/vod_genres?token=<TOKEN_ID>
[vods] Список фильмов VOD
Описание метода
Возвращает постраничный список доступных для клиента фильмов.
Формат запроса
http://api.tvplayer.fm/<API_VERSION>/<FORMAT_TYPE>/vods?token=<TOKEN_ID>&type=best&sort=asc&limit=5&page=2
- Необязательные параметры [optional]:
- type - возможные значения: last - сортировка по последним добавленным, best - по количеству просмотров.
- sort - возможные значения: asc - сортировка от меньшего к большему, desc - от большего к меньшему.
- genre - ID категорий, для указания нескольких категорий указываем их ID разделяя запятой - genre=1,2,5.
- text - текст от 3х символов который содержится в названии фильма или описании.
- limit - количество выводимых результатов. По умолчанию 10.
- page - номер страницы с результатами запроса, отсчет начинается с 0.
Описание полученных данных
- poster - URL постера маленького размера. Может возвращаться абсолютная или относительная ссылка на изображение постера. Если URL является относительным, то в качестве базы используется адрес сервера API введенного при авторизации.
[vod_info] Описание фильма
Описание метода
Возвращает информацию о фильме.
Формат запроса
http://api.tvplayer.fm/<API_VERSION>/<FORMAT_TYPE>/vod_info?token=<TOKEN_ID>&id=<VOD_ID>
- Обязательные параметры:
- id - ID фильма из метода vods.
Описание полученных данных
- poster - URL постера большого размера. Может возвращаться абсолютная или относительная ссылка на изображение постера. Если URL является относительным, то в качестве базы используется адрес сервера API введенного при авторизации.
[vod] Получение ссылки на фильм
Описание метода
Метод возвращает ссылку на фильм.
- Ссылка на фильм должна быть использована в течении 5 минут
- Ссылка на фильм привязана к IP клиента полученного в результате его запроса на сервер API.
- Ссылка на фильм привязана к серверу вещания для которого она была получена.
Формат запроса
http://api.tvplayer.fm/<API_VERSION>/<FORMAT_TYPE>/vod?token=<TOKEN_ID>&id=<VOD_ID>&protected=<PIN_CODE>
- Необязательные параметры [optional]:
- protected - PIN CODE (код родительского контроля)
- Обязательные параметры:
- id - ID фильма из метода vods.