Управление REST-методами

Переключение на свой web-сервер

По умолчанию все REST-запросы идут на локальный адрес: http://localhost:9091/EchoApp

При этом вызовы REST-методов имеют вид:

http://localhost:9091/EchoApp/connect

http://localhost:9091/EchoApp/playStream

http://localhost:9091/EchoApp/publishStream

и т.д.

Это происходит потому, что при подключении к WCS-серверу передается параметр appKey=defaultApp и в настройках WCS-сервера этому ключу соответствует URL http://localhost:9091/EchoApp

Чтобы поменять эти настройки, нужно зайти в CLI WCS-сервера через SSH: 

ssh -p 2000 admin@localhost

Пароль - тот, что использовался при установке WCS.

Стандартный пароль: admin

Если авторизация прошла успешно, WCS даст командную строку 

> 

Можете дать команду show apps, чтобы посмотреть как выглядят текущие приложения:

>show apps

Или команду help, чтобы вывести список доступных команд:

>help

Далее создаем собственный REST URL. Он создается командой add app.

Предположим, мы выделили под REST-методы следующие адреса на своем web-сервере:

http://mywebserver.com/rest/connect

http://mywebserver.com/rest/playStream

http://mywebserver.com/rest/publishStream

и т.д.

Тогда конфигурируем так:

>add app myApp myAppKey "http://mywebserver.com/rest"

Этой командой мы создали новый URL http://mywebserver.com/rest и указали, что этот URL будет использоваться, если клиентом при коннекте был передан ключ appKey=’myAppKey’.

Таким образом, если на клиенте при коннекте указать вновь созданный myAppKey, то управление будет передано на указанный URL:

Добавление и удаление REST-методов

По умолчанию REST-методы не добавляются к вновь сконфигурированному URL. Чтобы добавить REST-методы, воспользуйтесь следующими командами CLI:

>add app-rest-method -a myApp

Добавляет все существующие REST-методы к приложению myApp.

Если вы добавляете сразу все REST-методы, убедитесь, что все ваши HTTP URL-адреса: http://mywebserver.com/rest/connect, http://mywebserver.com/rest/playStream и остальные, - отвечают 200 OK и возвращают те данные, которые получили.

Кроме того, можно добавить один указанный REST-метод командой:

>add app-rest-method myApp connect

В этом случае будет добавлен только один REST-метод: connect.

Для удаления REST методов воспользуйтесь соответствующими командами

remove app-rest-method -a myApp

remove app-rest-method myApp connect

В этом случае REST-методы будут отсоединены от вашего URL, т.е. не будет производиться соответствующих REST-вызовов: connect, playStream и т.д.