API v 2.2 & 2.3

API sovok.tv

GET_URL

Сообщение Admin » 18 окт 2014, 23:46

/get_url?cid=<ИД канала>&protect_code=<код для закрытых каналов>&gmt=<timestamp>

Функция возвращает URL который специально сгенерирован для проигрывания через VLC с соответствующими оптимизированными параметрами.
( Пример: _http://sovok.tv/v2.2/xml/get_url?cid=1&protect_code=0000&gmt=1413673800)


Входные параметры:
  • cid - идентификатор канала полученный из channel_list
  • protect_code - цифровой код для закрытых каналов. Если канал защищен а код не передан, либо передан неверный код, то в тэге <url> возвращается "protected"
  • gmt - время в формате timestamp из start_time (EPG, время начала передачи) для получения ссылки на архив для канала cid

<?xml version="1.0" encoding="utf-8"?>
<response>
<url>
http/ts://a1.sovok.tv:8081/?ticket=cd89ccb1060dfa935086edc2d5dfdf9c65481913816f9cee9b7b7c294e48b11e4fc5937102611397ad2cab74624d0f32e41a5df3f594cee8af4811144706ea66776e9d4b752fb8a45e6c7c0f4661be2ad8ca197e082b7a5ca66e688a9f2fa15365063347265dd82fe9e4f126f1daa1f07ab9f926909e72abc37136dd74d99d51 :network-caching=3000 :http-caching=3000 :no-http-reconnect :aspect-ratio=16:9
</url>
<servertime>1413661923</servertime>
</response>
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

SETTINGS

Сообщение Admin » 18 окт 2014, 23:56

/settings

Функция возвращает текущие настройки.
( Пример: _http://sovok.tv/v2.2/xml/settings )

Вызов функции осуществляется без параметров.

<?xml version="1.0" encoding="utf-8"?>
<response>
<settings>
<streamer>1</streamer>
<timezone>+04:00:00</timezone>
<buffer>3000</buffer>
<deinterlace>bob</deinterlace>
</settings>
<servertime>1413662466</servertime>
</response>
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

SETTINGS_SET

Сообщение Admin » 19 окт 2014, 00:09

/settings_set?<timezone|buffer|deinterlace|ratio|streamer|pin1&pin2>=<Значение>

Функция устанавливает текущие настройки.
( Примеры:
  • _http://sovok.tv/v2.2/xml/settings_set?ratio=1:4:3timezone=+04:00:00&buffer=3000&deinterlace=0
  • _http://sovok.tv/v2.2/xml/settings_set?pin1=<НОВЫЙ_PIN1>&pin2=<ТЕКУЩИЙ_PIN2>
)

Входные параметры:
  • timezone -часовой пояс. Возможные значения:
    Код: Выделить всё
    -12:00
    -11:00
    -10:00
    -09:00
    -08:00
    -07:00
    -06:00
    -05:00
    -04:00
    -03:30
    -03:00
    -02:00
    -01:00
    +00:00
    +01:00
    +02:00
    +03:00
    +04:00
    +05:00
    +06:00
    +07:00
    +08:00
    +09:00
    +10:00
    +11:00
    +12:00
    +13:00
    +14:00
  • buffer - время буферизации в миллисекундах. Возможные значения от 1000 до 100000
  • deinterlace - деинтерлейс. Возможные значения - '0','blend','bob','discard','linear','mean','x','yadif','yadif2x'
  • ratio - устанавливает соотношение сторон для конкретного канала. Значение должно быть равно <ИД канала>:<4:3|16:9|221:100> (1:4:3)
  • streamer - ID стриммера из streamers
  • pin1 - установка PIN1, 4 цифры, используется в паре с PIN2 для подтверждения настройки
  • pin2 - используется в паре и для подтверждения изменения PIN1, 4 цифры

<?xml version="1.0" encoding="utf-8"?>
<response>
<settings>
<item>
<name>ratio</name>
<value>4:3</value>
<channel>1</channel>
</item>
<item>
<name>buffer</name>
<value>3000</value>
</item>
<item>
<name>deinterlace</name>
<value>0</value>
</item>
</settings>
<servertime>1413663357</servertime>
</response>
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

FAVORITES_SET

Сообщение Admin » 19 окт 2014, 00:15

/favorites_set?cid=<идентификатор канала>

Функция добавляет\удаляет канал из избранного.
( Пример: _http://sovok.tv/v2.2/xml/favorites_set?cid=1)
Повторный вызов функции для канала удаляет его из избранного.


Входные параметры:
  • cid - идентификатор канала полученный из channel_list

<?xml version="1.0" encoding="utf-8"?>
<response>
<message>
<text>Favorite channel was unset</text>
<channel>1</channel>
<code>3</code>
</message>
<servertime>1413663759</servertime>
</response>
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

FAVORITES

Сообщение Admin » 19 окт 2014, 00:18

/favorites

Функция возвращает список любимых каналов.
( Пример: _http://sovok.tv/v2.2/xml/favorites )


Вызов функции осуществляется без параметров.

<?xml version="1.0" encoding="utf-8"?>
<response>
<favorites>
<item>
<channel_id>1</channel_id>
</item>
<item>
<channel_id>2</channel_id>
</item>
<item>
<channel_id>3</channel_id>
</item>
</favorites>
<servertime>1413663872</servertime>
</response>
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

STREAMERS

Сообщение Admin » 19 окт 2014, 00:22

/streamers

Функция возвращает список доступных стрим-серверов.
( Пример: _http://sovok.tv/v2.2/xml/streamers )


Вызов функции осуществляется без параметров.

<?xml version="1.0" encoding="utf-8"?>
<response>
<streamers>
<item>
<id>1</id>
<name>Streamer 1</name>
</item>
<item>
<id>2</id>
<name>Streamer 2</name>
</item>
<item>
<id>3</id>
<name>Streamer 3</name>
</item>
</streamers>
<servertime>1413664133</servertime>
</response>
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

ARCHIVE_NEXT

Сообщение Admin » 20 окт 2014, 09:57

/archive_next?cid=<ИД канала>&time=<timestamp>

Функция возвращает URL архива для передачи начинающейся со времени timestamp
( Пример: _http://api.sovok.tv/v2.2/xml/archive_next?cid=1&time=1413795600)


Входные параметры:
  • cid - идентификатор канала
  • time - timestamp начала передачи

<?xml version="1.0" encoding="utf-8"?>
<response>
<archive>
<url>http/ts://a5.sovok.tv:8081/?ticket=9b274bd499b05918d950ce0d89d9775afb4cece6608a45234fc616316e49a7a9fff2536c6bbbd9ece944c41987f5748ebb7188fee50b8be8f8e0ba65efffa5e6c78e6d4cbd2e97f9bb719e0b74db364f92eedc0ae5e051e65b849e0edabf8ec570921e92a75fa8aae0c53469bd433f13cf9aa1416fbba70d309c698d1353611156572fb1087167186ed417084815b8a126a5524a1c1e237b0d1541f599eba0454ee6e0f280c8cfede6d96b0788c73f0d :network-caching=4000 :http-caching=4000 :no-http-reconnect :aspect-ratio=16:9 :audio-track=0
</url>
<progname>Новости.</progname>
<start>1413795600</start>
<end>1413796500</end>
</archive>
<servertime>1413784399</servertime>
</response>
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

Re: API v 2.2

Сообщение Admin » 20 окт 2014, 10:00

Обсуждение тут
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

Перемотка Архивов

Сообщение Admin » 02 дек 2014, 19:39

Так как поступает много вопросов по поводу перемотки архивов..

Перемотка осуществляется на данный момент двумя способами доступными из коробки в большинстве софтовых плееров.

Имеем url архива вида http://a12.sovok.tv:8081/?ticket=0b2ae3b

1 Cпособ:
Отправка заголовка HTTP_RANGE (bytes) при запросе url.

2 Cпособ:
Использование GET параметра start для url.
Код: Выделить всё
Пример: http://a12.sovok.tv:8081/?ticket=0b2ae3b&start=120

Где 120 - целое число, время в секундах от начала.
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

API v 2.3

Сообщение Admin » 21 дек 2014, 22:11

Обновили API в версию 2.3

* Исправили ошибку timestamp
* В channel_list и channel_list2 добавлена секция sprites
(http://api.sovok.tv/v2.3/xml/channel_list2, http://api.sovok.tv/v2.3/xml/channel_list)
Код: Выделить всё
<sprites>
  <item>
    <w>44</w>
    <h>25</h>
    <file>/logos/sprite44x25.png</file>
  </item>
  <item>
    <w>70</w>
    <h>40</h>
    <file>/logos/sprite70x40.png</file>
  </item>
</sprites>


и в свойство канала sprite_pos, которая отображает позицию логотипа в спрайте.

Данные параметры помогут облегчить загрузку логотипов различными девайсами.

Пример использования спрайтов можно посмотреть в нашем онлайн-плеере
Изображение
Admin
Администратор
 
Сообщения: 3144
Зарегистрирован: 15 мар 2012, 12:04

Пред.След.

Вернуться в REST API

Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 1