Ръководства
NICE API за собствени плейъри
Малко JSON API за собствен плейър или приложение за приставка: абонатът влиза и получава каналите, адресите на потоците и програмата.
1Вход
GET /api/json/login?login=user&pass=password
{
"sid": "50f91f0739c84b58ecb6a5c7d2",
"sid_name": "MW_SSID",
"account": { "login": "alex", "packet_name": "Nice", "packet_id": "1", "packet_expire": "1521676800" },
"services": 0, "settings": 0, "geo": 0, "messages": 0,
"servertime": 1517586814
}
Пазете sid. Отговорът го слага и като бисквитка MW_SSID; ако клиентът ви не пази бисквитки, добавяйте MW_SSID=<sid> към всяка заявка отдолу.
Грешки
{"error":{"message":"Access denied","code":3}} – грешен потребител или парола; {"error":{"message":"Login incorrect","code":4}} – няма сесия или е изтекла: влезте отново.
2Функции
| Заявка | Връща |
|---|---|
/api/json/channel_list | groups: категориите с техните channels (id, name, is_video) |
/api/json/categories_list | categories: id, name |
/api/json/icons_list | icons: ch_id и адресът на логото (source, празно = няма) |
/api/json/get_url?cid=1 | url – MPEG-TS адресът на канал 1 (кодиран, виж отдолу) |
/api/json/get_urlh?cid=1 | url – HLS адресът на канал 1 (кодиран) |
/api/json/epg_next?cid=1 | epg: текущото и следващото предаване |
/api/json/epg?cid=1 | epg: целият ден |
Пример – channel_list:
{
"groups": [
{ "id": "1", "name": "SPORT", "color": "Silver",
"channels": [ { "id": 1, "name": "1 tv", "is_video": 1 }, { "id": 2, "name": "2 tv", "is_video": 1 } ] }
],
"servertime": 1517589200
}
…и epg_next:
{
"epg": [
{ "ut_start": "1517584200", "progname": "Новини", "t_start": "15:10" },
{ "ut_start": "1517589300", "progname": "Футбол", "t_start": "16:35" }
],
"messages": 0, "servertime": 1517586897
}
3Декодиране на адреса
get_url и get_urlh връщат адреса кодиран в hex: всеки байт е изместен с 1…5 поред. На JavaScript:
function niceUrl(hex) {
var out = '', k = 0;
for (var i = 0; i < hex.length; i += 2) {
if (k > 4) k = 0;
k++;
out += String.fromCharCode(parseInt(hex.substr(i, 2), 16) - k);
}
return out; // напр. http://host:3000/…
}
Адресът води към сървъра, който трябва да обслужи абоната – при балансьори може да е слейв.