Table of Contents   MOBOTIX Online Help

HTTP-API

HTTP-API (Application Programming Interface/интерфейс прикладного программирования) - это интерфейс для соединения с камерой на основе программных средств, позволяющий интегрировать камеру в централизованную систему управления. Интерфейс состоит из двух сценариев CGI, которые Вы можете вызвать с помощью команд HTTP, используя параметры и значения. С помощью этих сценариев можно изменять настройки подменю меню Установка и осуществлять функции камеры.

Изменение настроек Установочного меню

Команда HTTP http://128.243.66.90/control/control позволит Вам изменить настройки Установочного меню.

Выполнение функций камеры

Команда HTTP http://128.243.66.90/control/rcontrol позволит Вам выполнять определенные функции камеры.

Важно: Некоторые функции по сохранению и восстановлению конфигурации могут выполняться лишь одним пользователем уровня admin (администратор). В этом случае с помощью другой команды HTTP необходимо вызвать сценарий rcontrol:
http://128.243.66.90/admin/rcontrol

Способ написания вызовов команд

Команда с предписанием

Если Вы хотите использовать, например, предписание list с командой control, последующее предписание должно быть отделено от команды знаком ?:
   http://128.243.66.90/control/control?list

Команда с предписанием и комбинацией параметров/значений

Чтобы было выполнено предписание с одним параметром, оно должно быть отделено от параметра знаком &. Значение параметра выделяется с помощью знака =:
   http://128.243.66.90/control/control?list&section=actions

Команда с предписанием и несколькими комбинациями параметров/значений

Если необходимо передать несколько параметров, необходимо разделить их с помощью знака &:
    http://128.243.66.90/control/rcontrol?action=ledson&time=5

Несколько значений для одного параметра

У некоторых параметров требуется указать два значения, чтобы было выполнено изменение в двух объективах. Эти параметры отличаются тем, что в качестве стандартных значений указываются два параметра (например, 0 0). В самой команде HTTP эти значения необходимо разделить знаком +:
   http://128.243.66.90/control/control?set&section=general&sharpen=0+0

Концы строк в вызовах команд

Если в вызове команды должен быть один или несколько концов строки (например, чтобы задать несколько определений окон для распознания движения), их необходимо отобразить с помощью знака замены CGI %0A:    http://128.243.66.90/control/control?set&section=general&
    coverimage_area=0,540,380,200,200,2%0A1,320,100,100,150,2

Специальные знаки в вызовах команд

Чтобы использовать сами знаки форматирования CGI или специальные знаки (конец строки, пробелы, умлауты, ...), введите знаки кодировано в формате URL-адреса. При этом используется знак %, за которым следует шестнадцатеричное значение знака, как в следующих примерах:

Знак Кодировка в формате URL-адреса Знак Кодировка в формате URL-адреса Знак Кодировка в формате URL-адреса
(конец строки) %0A (пробел) %20 или + % %25
& %26 + %2B = %3D
? %3F © %A9 ® %AE
Я %DF д %e4 Д %c4
ц %F6 Ц %D6 ь %FC
Ь %DC C %c7 a %e0
a %e1 a %E2 ? %E6
c %E7 e %E8 e %E9
e %EA e %EB i %ee
i %EF o %F4 u %F9
u %FA u %FB u %fc

Таблица цветовых тонов

Для определенных параметров можно указать цветовые тона, основанные на шестнадцатеричных значениях красного, зеленого и синего (RGB). Цвет определяют два знака; так, 00 обозначает наименьший цветовой тон (отсутствие цвета), FF обозначает максимальный цветовой тон (насыщенный цвет). Соответствующий цвет смешивается аддитивно, так что 0x000000 дает черный цвет, а 0xFFFFFF - белый.

Пример:

0xFF0000 Красный
0x00FF00 Зеленый
0x0000FF Синий

Имя цвета Шестнадцатер.обоз. Цвет Имя цвета Шестнадцатер.обоз. Цвет
Черный 0x000000   Красно-бурый 0x800000  
Нежно-зеленый 0x008000   Оливковый 0x808000  
Ультрамариновый 0x000080   Лиловый 0x800080  
Аквамарин 0x008080   Темно-серый 0x808080  
Светло-серый 0xC0C0C0   Красный 0xFF0000  
Зеленый 0x00FF00   Желтый 0xFFFF00  
Синий 0x0000FF   Пурпурный 0xFF00FF  
Голубой 0x00FFFF   Белый 0xFFFFFF  

Команда control

Сначала укажите камере, какое предписание должно быть выполнено.

Предписания для команды control

Предписание Описание
set Доступ по записи к настройкам изображения. Используйте это предписание для изменения настроек изображения.
http://128.243.66.90/control/control?set
read Доступ по считыванию к настройкам изображения. Используйте это предписание для запроса информации о настройках изображения.
http://128.243.66.90/control/control?read
list

Предписание list задает составление перечня разделов файла конфигурации, которые можно изменять.
Чтобы получить параметры раздела, добавьте к вызову фразу section=<имя раздела>.

Пример:
Команда http://128.243.66.90/control/control?list&section=actions позволяет получить перечень опций раздела actions (действие).

Эта команда позволяет как считывать текущие значения, так и вызывать опции и отображаемые тексты с помощью других программ.

factory С помощью предписания factory можно восстановить заводские настройки параметров раздела. В вызове в качестве дополнительного параметра необходимо также указать имя раздела: section=<имя раздела>.
http://128.243.66.90/control/control?factory&section=<имя раздела>
restore С помощью предписания restore можно восстановить значения параметров раздела, сохраненные последними во флэш-памяти. В вызове в качестве дополнительного параметра необходимо также указать имя раздела: section=<имя раздела>.
http://128.243.66.90/control/control?restore&section=<имя раздела>



Команда rcontrol

В сценарии в качестве первого значения всегда нужно указывать имя действия, которое должно быть выполнено. В зависимости от действия может также потребоваться указать дополнительные параметры. Среди дополнительных параметров различают обязательные параметры и параметры на выбор.

Указания:


Указание:

Можно отобразить все опции для команды rcontrol, для этого в строке адреса браузера необходимо использовать команду list:
http://128.243.66.90/control/rcontrol?list.

cn, de, en, es, fr, it, jp, ru

© 2001-2017 MOBOTIX AG, Germany · http://www.mobotix.com/