Ръководства
Web API: абонатите от вашата система
Свържете билинга или сайта си с панела: добавяне, промяна, изтриване и четене на абонати, кой гледа и смяна на източници на канали – с по една шифрирана GET заявка.
1Ключът
Configuration → WEB management → Wapi aes key:iv → Generate → Save. Двете стойности са по 16 знака. Без тях API-то отговаря {"info":"key_err"}.

Пазете ключа в тайна
Който има ключа, управлява абонатите ви. Същият ключ ползва и DVR-ът (виж „NICE DVR“) – след смяна го сменете и там. Старата документация показваше един общ ключ за всички: не го ползвайте, генерирайте свой.
2Как се прави заявката
- Командата се пише като JSON, напр.
{"command":"get","user":"alex"}. - Кодира се в base64.
- Текстът в base64 се шифрира с AES-128-CBC (ключ, IV) и резултатът се пише като hex.
- Вика се
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; каналът се рестартира |
enddate:"2027-01-31"или"2027-01-31T05:01:22".categories: ID на категориите, разделени със запетая;ip: разрешени IP, разделени със запетая (празно = всички).- Други отговори:
command_err(непозната команда),key_err(няма ключ),err(не може да се дешифрира – грешен ключ).
Отговор при четене, след дешифриране:
[{"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'])); ?>