NICE re/streamer pro

Ръководства

Web API: абонатите от вашата система

Свържете билинга или сайта си с панела: добавяне, промяна, изтриване и четене на абонати, кой гледа и смяна на източници на канали – с по една шифрирана GET заявка.

1Ключът

Configuration → WEB management → Wapi aes key:iv → Generate → Save. Двете стойности са по 16 знака. Без тях API-то отговаря {"info":"key_err"}.

Configuration → WEB management: Wapi aes key и iv с бутона Generate
Пазете ключа в тайна

Който има ключа, управлява абонатите ви. Същият ключ ползва и DVR-ът (виж „NICE DVR“) – след смяна го сменете и там. Старата документация показваше един общ ключ за всички: не го ползвайте, генерирайте свой.

2Как се прави заявката

  1. Командата се пише като JSON, напр. {"command":"get","user":"alex"}.
  2. Кодира се в base64.
  3. Текстът в base64 се шифрира с AES-128-CBC (ключ, IV) и резултатът се пише като hex.
  4. Вика се http://host:4300/wapi/<hex>.

Отговорите са {"info":"…"}. get и connections връщат {"user":"<hex>"} – шифрирано по същия начин: hex → дешифриране → base64 → JSON.

3Команди

КомандаJSONОтговор
Добавяне{"command":"add","user":"alex","pass":"1234","notes":"test","maxcon":"2","enddate":"2027-01-31","categories":"2,3,4","ip":"","reseller":"","balancer":""}add_ok · add_err · user_exists
Промянасъщите полета с "command":"edit"edit_ok · edit_err
Изтриване{"command":"del","user":"alex"}del_ok · del_err
Един абонат{"command":"get","user":"alex"}абонатът (шифриран)
Всички{"command":"get","user":"all_users"}всички абонати (шифрирано)
Връзки{"command":"connections","user":"all_users"}кой гледа: потребител, IP, плейър, вид, канал (шифрирано)
Източници на канал{"command":"channel","source":"reload","sources":{"12":["http://main/…","http://backup/…"]}}channel_ok · channel_err – основният и резервният източник на канал 12; каналът се рестартира

Отговор при четене, след дешифриране:

[{"id":1,"user":"alex","pass":"1234","categories":"1,14","enddate":1801382400,"notes":"free","maxcon":2,"ip":"","reseller":"","balancer":""}]

4Пример на PHP

<?php
$key = 'YOUR-16-CHAR-KEY';   // Configuration → WEB management → Wapi aes key
$iv  = 'YOUR-16-CHAR-IV.';   // … и iv
$api = 'http://host:4300/wapi/';

function wapi($cmd) {
  global $key, $iv, $api;
  $enc = openssl_encrypt(base64_encode(json_encode($cmd)), 'AES-128-CBC', $key, OPENSSL_RAW_DATA, $iv);
  $ans = json_decode(file_get_contents($api . bin2hex($enc)), true);
  if (isset($ans['user'])) {   // get / connections – шифрирано
    $dec = openssl_decrypt(hex2bin($ans['user']), 'AES-128-CBC', $key, OPENSSL_RAW_DATA, $iv);
    return json_decode(base64_decode($dec), true);
  }
  return $ans;                 // {"info":"add_ok"} …
}

print_r(wapi(['command' => 'add', 'user' => 'alex', 'pass' => '1234', 'notes' => 'test', 'maxcon' => '2',
              'enddate' => '2027-01-31', 'categories' => '2,3,4', 'ip' => '', 'reseller' => '', 'balancer' => '']));
print_r(wapi(['command' => 'get', 'user' => 'alex']));
?>