SAPI
Материал из OTV
Версия от 02:04, 8 января 2022; Admin (обсуждение | вклад)
Описание
В данной статье описывается возможное взаимодействие между клиентом и сервером API.
Договоренности
- Все временные метки только в формате Unixtime
- Boolean значение имеет следующее обозначение: положительное - 1, отрицательное - 0»
- Кодировка UTF8.
Все запросы к API формируются по специально сформированному URL и имеют следующий вид:
httр://sapi.ott.st/v<api_version>/<type>/<method>?param1=value¶m2=value&token=<token>
| <api_version> | Версия API. Текущая версия 2.4 |
| <type> | Формат ответа API. Может принимать следующие параметры:
|
| <method> | Метод API, описания которых предоставлены ниже. |
| <token> | Уникальный ключ авторизации. Всегда равен md5(strtolower($login) . md5($password)) (пример на PHP) |
Пример запроса к API:
httр://sapi.ott.st/v2.4/json/get_url?cid=1&token=sessiontoken
Логотипы каналов
Получить логотип канала можно по следующему URL:
http://ott.st/logos/<channel_id>.png
Где <channel_id> - ID канала.
Методы
[account] Аккаунт
Описание метода
Выводит информацию об аккаунте.
Формат запроса
httр://sapi.ott.st/v2.4/xml/account?token=sessiontoken
Формат ответа
<?xml version="1.0" encoding="utf-8"?>
<response>
<account>
<login>[логин]</login>
<tz>[таймзона]</tz>
<first_name>[имя]</first_name>
<last_name>[фамилия]</last_name>
<city>[имя]</city>
<country>[имя]</country>
<packages>
<item>
<id>[id слуги]</id>
<type>[тип услуги]</type>
<name>[название услуги]</name>
<expire>[время окончания подписки]</expire>
</item>
<item>
<id>2</id>
<type>1</type>
<name>Базовый</name>
<expire>1673108501</expire>
</item>
<item>
<id>3</id>
<type>1</type>
<name>Взрослый</name>
<expire>1523115026</expire>
</item>
...
</packages>
</account>
<servertime>[время сервера]</servertime>
</response>