API VOD — различия между версиями

Материал из TVPlayer.FM
Перейти к:навигация, поиск
Строка 37: Строка 37:
 
::'''id''' - ID фильма из метода vods.
 
::'''id''' - ID фильма из метода vods.
 
===Описание полученных данных===
 
===Описание полученных данных===
:: '''poster''' - URL постера маленького размера. Может возвращаться абсолютная или относительная ссылка на изображение постера. Если URL является относительным, то в качестве базы используется адрес сервера API введенного при авторизации.
+
:: '''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.