The HTTP API (Application Programming Interface) is a software interface to the camera and allows to conveniently integrate the camera into a centralized management system. The interface consists of two CGI scripts that can be called with parameters and values using HTTP commands. By means of these scripts, you can modify the settings of the Setup submenus and execute certain camera functions.
Modifying the Settings of the Setup MenuUsing the HTTP command http://192.168.11.100/control/control
, you can modify the settings of the Setup menu.
Executing Camera Functions
Using the HTTP command http://192.168.11.100/control/rcontrol
, you can execute certain camera functions.
Important: |
Certain functions for Saving and Restoring the configuration can only be performed by a user of the admin access level. In this case, you need another HTTP command for calling the rcontrol script, namely:http://192.168.11.100/admin/rcontrol
|
---|
If you would like to use the list
instruction with the control
command, you need to separate the instruction from the command using a ?:
http://192.168.11.100/control/control?list
In order to execute an instruction with a parameter, the instruction needs to be separated from the parameter by an ampersand &. The parameter value is separated by a =
sign.
http://192.168.11.100/control/control?list§ion=action
If you would like to use multiple parameters, separate them using an ampersand &:
http://192.168.11.100/control/rcontrol?action=ledson&time=5
For some parameters you need to enter two values in order to address both lenses. These parameters are shown as having two default values (e.g. 0 0
). In the http command, you will need to separate these values using a + sign :
http://192.168.11.100/control/control?set§ion=general&sharpen=0+0
If you would to use one or more newline characters in a command (e.g. to set several video motion window definitions), you need to replace the newline characters using the CGI replacement string %0A
. http://192.168.11.100/control/control?set§ion=general&
coverimage_area=0,540,380,200,200,2%0A1,320,100,100,150,2
In order to display the CGI formatting strings themselves (newline, blank, umlauts, ...), enter the URL-encoded characters. To do this, enter a %
sign followed by the hex value of the character you would like to display. The following table contains a list of the most common characters:
Character | URL-Encoding | Character | URL-Encoding | Character | URL-Encoding |
---|---|---|---|---|---|
(Newline) | %0A |
(Blank) | %20 or + |
% | %25 |
& | %26 |
+ | %2B |
= | %3D |
? | %3F |
© | %A9 |
® | %AE |
ß | %DF |
ä | %e4 |
Ä | %c4 |
ö | %F6 |
Ö | %D6 |
ü | %FC |
Ü | %DC |
Ç | %c7 |
à | %e0 |
á | %e1 |
â | %E2 |
æ | %E6 |
ç | %E7 |
è | %E8 |
é | %E9 |
ê | %EA |
ë | %EB |
î | %ee |
ï | %EF |
ô | %F4 |
ù | %F9 |
ú | %FA |
ù | %FB |
û | %fc |
You may specify color values for certain parameters. These values correspond to the hex values of the red, green and blue (RGB) values of a specific color. Two characters each represent on color, 00
represents the lowest value (no color), FF
represents the highest value (full color). As the colors are mixed additively, 0x000000
will be black and 0XFFFFFF
will be white.
Example:
0xFF0000 |
Red |
0x00FF00 |
Green |
0x0000FF |
Blue |
Color name | Hexadecimal notation | Color | Color name | Hexadecimal notation | Color |
---|---|---|---|---|---|
Black | 0x000000 |
Maroon | 0x800000 |
||
Dark green | 0x008000 |
Olive | 0x808000 |
||
Marine | 0x000080 |
Purple | 0x800080 |
||
Teal | 0x008080 |
Dark gray | 0x808080 |
||
Light gray | 0xC0C0C0 |
Red | 0xFF0000 |
||
Green | 0x00FF00 |
Yellow | 0xFFFF00 |
||
Blue | 0x0000FF |
Magenta | 0xFF00FF |
||
Cyan | 0x00FFFF |
White | 0xFFFFFF |
First of all, you need to tell the camera which instructions are to be performed.
Instruction | Description |
---|---|
set |
Write access to the image settings. Use this instruction to modify the image settings.http://192.168.11.100/control/control?set
|
read |
Read access to the image settings. Use this instruction to query information about the image settings.http://192.168.11.100/control/control?read
|
list |
The list instruction returns a list of the configuration file sections that can be modified.
Example: This command allows reading the current values and it provides a method for obtaining the options and the texts of the user interface by other applications. |
factory |
The factory instruction allows you to reset the parameters of a section to the factory default settings. This call requires the section name section=<sectionname> as additional parameter.http://192.168.11.100/control/control?factory§ion=<sectionname>
|
restore |
The restore instruction allows you to reset the parameters of a section to the values stored in the flash memory. This call requires the section name section=<sectionname> as additional parameter.http://192.168.11.100/control/control?restore§ion=<sectionname>
|
The first value expected by the script is always the name of the action that is to be performed. Depending on the action, you may have to provide additional parameters. For the additional parameters mandatory and optional parameters are used.
Notes:
Note: |
In order to see all options for the rcontrol command, enter the |
---|
de, en |