Getting started with the HTTP API


An application-programming interface (API) is a set of programming instructions and standards for accessing a software application or Web tool. An API is a software-to-software interface, not a user interface. With APIs, applications talk to each other without any user knowledge or intervention.


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 several 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 dialogs in Setup Menu and execute certain camera functions.

Most common uses

  • Modification of the configuration: recordings, events, actions, etc.
  • Modification of the image settings: exposure, image quality, image resolution, etc.
  • Status requests
  • Triggering of actions

API HTTP request description

A normal HTTP request from the browser looks like this:

which can be split in the following:

  • protocol: http://
  • destination: <ip_address_for_the_camera>
  • cgi-call: /control/control
  • parameters: list&section=recording

so a well formed request is of the form:
protocol + destination + cgi-call + parameters

The previous request will deliver the following HTTP response:

where the current configuration options for recordings are visualized.

CGI Calls


Using the HTTP command

you can modify the settings of the Setup menu. Type

to display the different sections available.


Using the HTTP command

you can modify the settings of the Admin menu. Type
to display the different sections available.

/control/rcontrol and /admin/rcontrol

Using the HTTP command

you can visualize specific actions which can be executed

by calling this HTTP request the camera will play a sound file.

Some of these functions can only be called as an admin user

in this case the HTTP Request would be:

vPTZ Settings

As a consequence of integrating the Q camera models, the cameras offer vPTZ features (virtual Pan/Tilt/Zoom) also in the HTTP API. The corresponding features have been documented on specific help dialogs, which can be opened using the corresponding links:


This interface provides limited access to simple vPTZ features.


This interface provides full access to all vPTZ features.


control also provides access to some vPTZ features, as outlined in the vptzcontrol section.

Image CGI-Calls

Additionally there is a set of CGI calls to retrieve live images, video streams and recordings of the camera directly from the integrated web server.



  • Retrieves a camera image according to the current image settings
  • You cannot specify any additional parameters



  • Retrieves a camera image using additional image parameters.
  • The saved configuration is not changed and does not affect the live image.


  • camera=right is the right lens on dual cameras
  • size=320x240 is the resolution of the image
  • quality=60 is the quality percentage

Appending ?help to the end of the command will display the corresponding help page with all the options available:

/cgi-bin/faststream.jpg or /control/faststream.jpg

Retrieves the live stream from the camera using additional image parameters.

  • /cgi-bin/faststream.jpg with guest access
  • /control/faststream.jpg with user access


Provides access the camera’s events and allows adding additional parameters.

The following request, for example, delivers the last event image of the camera:

Appending ?help to the end of the command will display the corresponding help page with al the options available:

Additional help

The help pages on the camera provide an overview of the API commands and addtional examples. The help pages can be accessed clicking on the ? icon on the top right corner of the camera web interface or via the url:


Down at the bottom of the MOBOTIX Online Help is the Remote-Controlling section

1 Like