API VOD — различия между версиями
Материал из TVPlayer.FM
Admin (обсуждение | вклад) |
Admin (обсуждение | вклад) |
||
Строка 37: | Строка 37: | ||
::'''id''' - ID фильма из метода vods. | ::'''id''' - ID фильма из метода vods. | ||
===Описание полученных данных=== | ===Описание полученных данных=== | ||
− | :: '''poster''' - URL постера | + | :: '''poster''' - URL постера большого размера. Может возвращаться абсолютная или относительная ссылка на изображение постера. Если URL является относительным, то в качестве базы используется адрес сервера API введенного при авторизации. |
+ | |||
+ | |||
+ | == [vod] Получение ссылки на фильм== | ||
+ | |||
+ | ===Описание метода=== | ||
+ | Метод возвращает ссылку на фильм. | ||
+ | *Ссылка на фильм должна быть использована в течении 5 минут | ||
+ | *Ссылка на фильм привязана к IP клиента полученного в результате его запроса на сервер API. | ||
+ | *Ссылка на фильм привязана к серверу вещания для которого она была получена. | ||
+ | |||
+ | ===Формат запроса=== | ||
+ | <pre>http://api.tvplayer.fm/<API_VERSION>/<FORMAT_TYPE>/vod?token=<TOKEN_ID>&id=<VOD_ID></pre> | ||
+ | :Обязательные параметры: | ||
+ | ::'''id''' - ID фильма из метода vods. |
Версия 00:05, 21 апреля 2020
Содержание
VOD API
[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>
- Обязательные параметры:
- id - ID фильма из метода vods.