Серверный HTTP интерфейс - История изменений

Oktell Support в 14:53, 12 октября 2017

2017-10-12T14:53:18Z

Oktell Support в 09:39, 14 июля 2017

2017-07-14T09:39:36Z

Oktell Support в 09:38, 14 июля 2017

2017-07-14T09:38:57Z

Peter в 12:33, 30 июня 2014

2014-06-30T12:33:04Z

Oktell Support в 12:24, 14 апреля 2014

2014-04-14T12:24:33Z

Внесённые изменения

Peter в 15:08, 20 января 2014

2014-01-20T15:08:56Z

Peter в 15:07, 20 января 2014

2014-01-20T15:07:05Z

Peter в 14:24, 20 января 2014

2014-01-20T14:24:00Z

Oktell Support в 10:54, 22 ноября 2013

2013-11-22T10:54:59Z

Oktell Support в 10:54, 22 ноября 2013

2013-11-22T10:54:41Z

@@ Строка 59: / Строка 59: @@
 -------------------------------
-'''execsvcscriptplain'''. Аналогично методу <span style="gray;">execsvcscript</span> осуществляет запуск произвольного служебного сценария на сервере (код запуска 27) с такими же параметрами. Отличие состоит в том, что ответ сценария, сохраненный в переменную «Выходное значение» без искажений размещается в контенте ответа на запрос, в то время как базовый метод обрамляет ответ в XML формат.
+'''execsvcscriptplain'''. Аналогично методу <span style="gray;">execsvcscript</span> осуществляет запуск произвольного служебного сценария на сервере (код запуска 27) с такими же параметрами. Отличие состоит в том, что ответ сценария, сохраненный в переменную «Возвращаемое значение 1» без искажений размещается в контенте ответа на запрос, в то время как базовый метод обрамляет ответ в XML формат.
 <span style="color:green;">

← Предыдущая		Версия 09:39, 14 июля 2017
Строка 566:		Строка 566:
	'''wp_abortcall'''. Положить трубку. Завершает звонок.		'''wp_abortcall'''. Положить трубку. Завершает звонок.

−	http://login:password@192.168.0.1:4055/~~wp_declinecall~~?line=16001	+	http://login:password@192.168.0.1:4055/wp_abortcall?line=16001

← Предыдущая		Версия 09:38, 14 июля 2017
Строка 553:		Строка 553:

	http://login:password@192.168.0.1:4055/wp_declinecall?wp=OPERATOR1		http://login:password@192.168.0.1:4055/wp_declinecall?wp=OPERATOR1
		+
		+
		+	-------------------------------
		+
		+	'''wp_answercall'''. Отвечает на входящий вызов.
		+
		+	http://login:password@192.168.0.1:4055/wp_answercall?user=ivan
		+
		+
		+	-------------------------------
		+
		+	'''wp_abortcall'''. Положить трубку. Завершает звонок.
		+
		+	http://login:password@192.168.0.1:4055/wp_declinecall?line=16001

@@ Строка 115: / Строка 115: @@
 -------------------------------
@@ Строка 195: / Строка 216: @@
 '''download'''. Позволяет скачать файл с сервера.
-::* download/rec/ABC, download/fax/ABC - предоставляет файлы записей разговоров и файлы полученных факсимильных сообщений. Правильная ссылка предоставляется через web-socket подключение. В качестве дополнительного может использоваться параметр ''attachment''.
+::* download/rec/ABC, download/fax/ABC, download/vm/id - предоставляет файлы записей разговоров, файлы полученных факсимильных сообщений, файлы голосовой почты. Правильная ссылка предоставляется через web-socket подключение. В качестве дополнительного может использоваться параметр ''attachment''.
 ::* download/byscript - предоставляет доступ к произвольному файлу, путь к которому определяется служебным сценарием, запускаемым этим запросом. Используются все параметры для метода [[#execsvcscript|execsvcscript]], а также дополнительный параметр ''attachment''. Считается что сценарий вернет путь к файлу, который и будет возвращен.

@@ Строка 64: / Строка 64: @@
 Для того, чтобы исполнять некоторые служебные сценарии без базовой авторизации можно воспользоваться следующей схемой. Из каталога ''WWW'' файлы отдаются без авторизации. Дополнительные изменения в этом каталоге администратором сервера могут инициировать выдачу ответа не в виде содержимого файла, а в виде результата работы служебного сценария. Разберем на примере, остальное вы сможете сделать по собственным задачам.
 . Положите в папку ''WWW'' в рабочем каталоге сервера файл ''test.html'' с любым тестовым содержимым.
 . Выполните запрос ''http://server:port/test.html'', подставив адрес и порт доступа к веб-серверу Oktell. Без пароля должно вернуться и отобразиться в браузере содержимое файла.
 . Рядом с файлом ''test.html'' создайте файл ''test.html.execsvcscriptplain'', в его тело разместите JSON-форматированную строку, например:
 <pre>
+{
@@ Строка 78: / Строка 80: @@
 </pre>
 . Создайте служебный сценарий ''myscript'', выводящий какое-нибудь уведомление, чтобы было видно и понятно, что сценарий запустился.
 . Выполните тот же запрос ''http://server:port/test.html'' — уведомление должно отобразиться.
 . Все параметры GET запроса (или POST запроса с ''Content-type: application/x-www-form-urlencoded'') будут разобраны и переданы на старт сценария точно также, как если бы исполнялся метод ''execsvcscriptplain''. То есть значения параметров, условия исполнения — асинхр/синхр, таймаут ожидания и.т.д.
 . В качестве значения служебной переменной ''Выходное значение'' сценария вы можете организовать вывод любого содержимого, в том числе и HTML страницы, которое будет без изменений возвращено в теле HTTP-ответа.
 . Для передачи в сценарий некоторых служебных данных из тела HTTP-запроса существуют специальные значения, которые можно принудительно назначить в качестве значений одного из пяти возможных стартовых параметров служебного сценария (оригинальные значения, передаваемые в сценарий с помощью параметров GET будут в этом случае частично или полностью перезатерты):
 %parameters% — строка параметров GET в неразобранном виде;
@@ Строка 93: / Строка 100: @@
 %requestline% — полный текст строки-запроса;
 Например:
 <pre>
+{
@@ Строка 102: / Строка 110: @@
 </pre>
 При этом значения параметров 2, 4 и 5 будут переданы из самого GET запроса, если они в нем указаны.
 </span>
 -------------------------------

← Предыдущая		Версия 15:07, 20 января 2014
Строка 61:		Строка 61:
	'''execsvcscriptplain'''. Аналогично методу <span style="gray;">execsvcscript</span> осуществляет запуск произвольного служебного сценария на сервере (код запуска 27) с такими же параметрами. Отличие состоит в том, что ответ сценария, сохраненный в переменную «Выходное значение» без искажений размещается в контенте ответа на запрос, в то время как базовый метод обрамляет ответ в XML формат.		'''execsvcscriptplain'''. Аналогично методу <span style="gray;">execsvcscript</span> осуществляет запуск произвольного служебного сценария на сервере (код запуска 27) с такими же параметрами. Отличие состоит в том, что ответ сценария, сохраненный в переменную «Выходное значение» без искажений размещается в контенте ответа на запрос, в то время как базовый метод обрамляет ответ в XML формат.

		+	<span style="color:green;">
		+	Для того, чтобы исполнять некоторые служебные сценарии без базовой авторизации можно воспользоваться следующей схемой. Из каталога ''WWW'' файлы отдаются без авторизации. Дополнительные изменения в этом каталоге администратором сервера могут инициировать выдачу ответа не в виде содержимого файла, а в виде результата работы служебного сценария. Разберем на примере, остальное вы сможете сделать по собственным задачам.
		+
		+	1. Положите в папку ''WWW'' в рабочем каталоге сервера файл ''test.html'' с любым тестовым содержимым.
		+
		+	2. Выполните запрос ''http://server:port/test.html'', подставив адрес и порт доступа к веб-серверу Oktell. Без пароля должно вернуться и отобразиться в браузере содержимое файла.
		+
		+	3. Рядом с файлом ''test.html'' создайте файл ''test.html.execsvcscriptplain'', в его тело разместите JSON-форматированную строку, например:
		+
		+	<pre>
		+	{
		+	"scriptname":"myscript",
		+	"timeout":10,
		+	"parameter1":"ЧЕРЕЗ WWW"
		+	}
		+	</pre>
		+
		+	4. Создайте служебный сценарий ''myscript'', выводящий какое-нибудь уведомление, чтобы было видно и понятно, что сценарий запустился.
		+
		+	5. Выполните тот же запрос ''http://server:port/test.html'' — уведомление должно отобразиться.
		+
		+	6. Все параметры GET запроса (или POST запроса с ''Content-type: application/x-www-form-urlencoded'') будут разобраны и переданы на старт сценария точно также, как если бы исполнялся метод ''execsvcscriptplain''. То есть значения параметров, условия исполнения — асинхр/синхр, таймаут ожидания и.т.д.
		+
		+	7. В качестве значения служебной переменной ''Выходное значение'' сценария вы можете организовать вывод любого содержимого, в том числе и HTML страницы, которое будет без изменений возвращено в теле HTTP-ответа.
		+
		+	8. Для передачи в сценарий некоторых служебных данных из тела HTTP-запроса существуют специальные значения, которые можно принудительно назначить в качестве значений одного из пяти возможных стартовых параметров служебного сценария (оригинальные значения, передаваемые в сценарий с помощью параметров GET будут в этом случае частично или полностью перезатерты):
		+	%parameters% — строка параметров GET в неразобранном виде;
		+	%content% — контент запроса;
		+	%headers% — все заголовки HTTP запроса (фактически полный текст запроса без контента);
		+	%page% — адрес запрошенной страницы;
		+	%requestline% — полный текст строки-запроса;
		+	Например:
		+	<pre>
		+	{
		+	"scriptname":"myscript",
		+	"timeout":10,
		+	"parameter1":"Константа",
		+	"parameter3":"%page%"
		+	}
		+	</pre>
		+
		+	При этом значения параметров 2, 4 и 5 будут переданы из самого GET запроса, если они в нем указаны.
		+	</span>

	-------------------------------		-------------------------------

← Предыдущая		Версия 14:24, 20 января 2014
Строка 495:		Строка 495:

	* <span style="color:green;">oncallcenter</span> - 0 или 1, определяет активность режима call-центра. Производит дополнительно смену состояний, если текущее состояние противоречит выбранному режиму (вывод из перерыва при выходе, вывод из переадресации при входе в call-центр).		* <span style="color:green;">oncallcenter</span> - 0 или 1, определяет активность режима call-центра. Производит дополнительно смену состояний, если текущее состояние противоречит выбранному режиму (вывод из перерыва при выходе, вывод из переадресации при входе в call-центр).
		+
		+	* <span style="color:green;">onccmanual</span> - 0 или 1, определяет активность ручного режима в call-центре. Может быть изменено только при нахождении пользователя в call-центре.

	* <span style="color:green;">onlunch</span> - 0 или 1, определяет активность режима перерыва. Доступно только при включенном режиме call-центра. Может выставляться как отдельно, так и одновременно с определением других режимов состояния. При активном режиме перерыва пользователь переводится в состояние перерыва вместо готовности всякий раз, как только освобождается. Вместе с переводом в режим перерыва возможно указание причины и кода причины перерыва (параметры lunchreasonid и lunchreasonmsg) - для регламентированных причин, содержащихся в БД указывается только код, для индивидуальных причин указывается только текст.		* <span style="color:green;">onlunch</span> - 0 или 1, определяет активность режима перерыва. Доступно только при включенном режиме call-центра. Может выставляться как отдельно, так и одновременно с определением других режимов состояния. При активном режиме перерыва пользователь переводится в состояние перерыва вместо готовности всякий раз, как только освобождается. Вместе с переводом в режим перерыва возможно указание причины и кода причины перерыва (параметры lunchreasonid и lunchreasonmsg) - для регламентированных причин, содержащихся в БД указывается только код, для индивидуальных причин указывается только текст.

@@ Строка 17: / Строка 17: @@
 Запросы могут поступать с использованием методов GET и POST. Как GET, так и POST запрос позволяет перечислять параметры в URL.
-Использование basic-авторизации, например:
+Использование''' basic-авторизации''', например:
   http://login:password@192.168.0.1:4055/wp_setuserstate?user=admin&userstateid=5

← Предыдущая		Версия 10:54, 22 ноября 2013
Строка 17:		Строка 17:
	Запросы могут поступать с использованием методов GET и POST. Как GET, так и POST запрос позволяет перечислять параметры в URL.		Запросы могут поступать с использованием методов GET и POST. Как GET, так и POST запрос позволяет перечислять параметры в URL.

		+	Использование basic-авторизации, например:
		+	http://login:password@192.168.0.1:4055/wp_setuserstate?user=admin&userstateid=5