Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

General request format:

GET http://IP-address:port/web2/secure/configuration?pageItems={pageItems}&page={page} 

Request parameters:

of objects displayed on the page. page > 0. By default, page=1000.
ParameterIs requiredDescription
pageItemsNo

Sets the

page

number

displayed as a result of the request. pageItems > 0. By default, pageItems=1.

of objects displayed on the page. The value must be greater than 0, by default page=1000.

The page parameter only applies when the pageItems parameter is specified

pageNo

Sets the page number

displayed as a result of the request. The value must be greater than 0, by default pageItems=1


Note
titleAttention!

If there are many objects in the system (>1000) they are to be displayed by pages.

Processing of all objects is performed page by pare until an empty array is received.

Request example:

GET http://127.0.0.1:8085/web2/secure/configuration

Response example:

The request returns the list of the following objects with states:

  • cameras added to the Web-server with IDs of linked microphones, dynamics, PTZ devices, presets, as well as monitors and displays to which the camera added (see also Selecting and configuring cameras for the Web-server module);
  • displays and monitors on which the cameras added to the Web-server are displayed;
  • cameras added to maps selected for Web Server 2.0 are returned – see Selecting maps;
  • sensors;
  • relays;
  • macros;
  • RTSP servers with ports used, cameras added;
  • list of zones and regions.

JSON:

Code Block
languagejs
[
    {
        "id": "1",
        "name": "Area 1",
        "regions": [
            {
                "id": "1.1",
                "zoneId": "1",
                "name": "Region 1.1",
                "zoneDescription": "Zone description"
            }
        ]
    },
    {
        "type": "DISPLAY",
        "id": "DISPLAY:1",
        "extId": "1",
        "name": "Display 1",
        "displayId": "1",
        "state": {
            "id": "normal",
            "type": "NORMAL",
            "fullState": null
        }
    },
    {
        "type": "MACRO",
        "id": "MACRO:2",
        "extId": "2",
        "name": "Macro 2",
        "state": {
            "id": "normal",
            "type": "NORMAL",
            "fullState": null
        }
    },
    {
        "type": "STREAMING_SERVER",
        "id": "STREAMING_SERVER:1",
        "extId": "1",
        "name": "RTSP Server 1",
        "state": {
            "id": "normal",
            "type": "NORMAL",
            "fullState": null
        },
        "port": "554",
        "cams": "1;;;;;;"
    },
    {
        "type": "CAM",
        "id": "CAM:1",
        "extId": "1",
        "name": "Camera 1",
        "displayId": "1",
        "monitorId": "1",
        "state": {
            "id": "connected_recording",
            "type": "NORMAL",
            "fullState": "DISARMED|RECORDER_ON|RECORDING"
        },
        "presets": []
    },
    {
        "type": "SLAVE",
        "id": "SLAVE:R-GYZYEVCOMP",
        "extId": "R-GYZYEVCOMP",
        "name": "Computer DESKTOP-JHRURJJ",
        "state": {
            "id": "connected",
            "type": "NORMAL",
            "fullState": null
        }
    },
    {
        "type": "MONITOR",
        "id": "MONITOR:1",
        "extId": "1",
        "name": "Monitor 1",
        "displayId": "1",
        "monitorId": "1",
        "state": {
            "id": "normal",
            "type": "NORMAL",
            "fullState": null
        },
        "camList": [
            "1"
        ]
    }
]  

XML:

Code Block
languagexml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<baseObjects>
    <CAM>
  <baseObjects>
   <CAM>
      <displayId>1</displayId>
      <extId>9</extId>
      <geo_angle>0.0</geo_angle>
      <id>CAM:9</id>
      <latitide>-98.0533</latitide>
      <longitude>56.4089</longitude>
      <monitorId>1;2</monitorId>
      <name>Camera 9</name>
      <regionId />
      <state>
         <fullState>DISARMED</fullState>
         <id>connected</id>
         <type>NORMAL</type>
      </state>
      <type>CAM</type>
      <additionalInfo />
      <micId />
      <presets />
      <speakerId />
      <telemetryId />
   </CAM>
   <baseObject>
      <displayId>1</displayId>
      <extId>1</extId>
      <id>DISPLAY:1</id>
      <displayName>Display 1</displayName>
  <name>Display 1</name>
      <state>
         <id>normal</id>
         <type>NORMAL</type>
      </state>
      <type>DISPLAY</type>
   </baseObject>
   <CAM>
      <displayId>1</displayId>
      <extId>5</extId>
      <geo_angle>0.0</geo_angle>
      <id>CAM:5</id>
      <latitide>-97.6674</latitide>
      <longitude>56.3588</longitude>
      <monitorId>1</monitorId>
      <name>pos</name>
      <regionId />
      <state>
         <fullState>DISARMED</fullState>
         <id>connected</id>
         <type>NORMAL</type>
      </state>
      <type>CAM</type>
      <additionalInfo />
      <micId />
      <presets />
      <speakerId />
      <telemetryId />
   </CAM>
   <STREAMING_SERVER>
      <cams>1;2;3;4;5;6;9;;;;;;;;;;</cams>
      <extId>1</extId>
      <id>STREAMING_SERVER:1</id>
  <monitorName>Monitor 1</monitorName>    <name>RTSP Server 1</name>
      <state>
         <id>normal</id>
         <type>NORMAL</type>
      </state>
      <type>STREAMING_SERVER</type>
      <port>5543</port>
   </STREAMING_SERVER>
   <CAM>
      <displayId>1</displayId>
     <name>Camera 5<<extId>1</name>extId>
      <geo_angle>0.0</geo_angle>
     <regionDescription>Region description<<id>CAM:1</regionDescription>id>
      <latitide>-98.3293</latitide>
  <regionId>2.1</regionId>
      <longitude>56.741</longitude>
      <monitorId>1;2</monitorId>
      <name>Camera 1</name>
      <regionDescription />
      <regionId>1.1</regionId>
      <regionName>Region 21.1</regionName>
      <state>
         <fullState>DISARMED</fullState>
         <id>connected</id>
         <type>NORMAL</type>
      <state>
  </state>
      <type>CAM</type>
      <zoneId>1</zoneId>
      <zoneName>Area 1</zoneName>
      <additionalInfo />
      <micId />
      <presets />
      <speakerId />
      <telemetryId />
   <fullState>DISARMED<</fullState>CAM>
   <SLAVE>
      <extId>COMP</extId>
   <id>connected</id>   <id>SLAVE:COMP</id>
      <name>LOCALHOST</name>
      <state>
         <id>connected</id>
         <type>NORMAL</type>
      </state>
      <type>SLAVE</type>
   </state>SLAVE>
   <baseObject>
      <type>CAM<<displayId>1</type>displayId>
      <extId>2</extId>
      <zoneId>2<<id>MONITOR:2</zoneId>id>
      <monitorId>2</monitorId>
  <zoneName>Zone 2</zoneName>
        <additionalInfo></additionalInfo>    <name>Monitor 2</name>
      <state>
         <id>normal</id>
         <type>NORMAL</type>
      </state>
      <type>MONITOR</type>
   </baseObject>
   <baseObject>
      <displayId>1</displayId>
      <extId>1</extId>
  <micId></micId>
     <id>MONITOR:1</id>
      <monitorId>1</monitorId>
      <name>Monitor <presets/>
1</name>
      <state>
         <speakerId><<id>normal</speakerId>id>
        <telemetryId></telemetryId>
 <type>NORMAL</type>
      </state>
      <type>MONITOR</type>
   </CAM>baseObject>
</baseObjects>

Response parameters:


ParameterDescription
General parameters

extId

Object ID

id

Object type and ID in the format TYPE:ID

name

Object name

state

Object state. The <id>, <type> and <fullState> description see in State of a specific object.

type

Object type
Specific parameters

cams

List of cameras added to the RTSP Server with semicolon as a separator.

port

Port used by RTSP Server
regionDescriptionRegion description

regionId

ID of the region to which the object is added
regionNameRegion name
zoneIdID of the zone to which the object is added
zoneNameZone name
latitideLatitude (object coordinate).

The parameter has non-zero value if:

  1. An external map is used for the layer background (see Configuring the external map Map server), or
  2. The layer is tied to geo coordinates (see Configuring map binding to coordinate grid).
longitudeLongitude (object coordinate).

The parameter has non-zero value if:

  1. An external map is used for the layer background (see Configuring the external map Map server), or
  2. The layer is tied to geo coordinates (see Configuring map binding to coordinate grid).
monitorIdFor camera: ID of the monitor to which the camera is added. If there are several IDs, they are separated by a semicolon ";"
monitorNameFor cameramonitor: name of the monitor to which the camera is added.
geo_angleFor camera: viewing angle (for camera, see Configuring the camera viewing angle display on the Map)
additionalInfo For camera: the Additional info field value
micId For camera: the ID of the associated microphone.
presets For camera: preset list.
speakerId For camera: the ID of the associated speaker.
telemetryId For camera: the ID of the PTZ control panel.
displayIdFor interface objects: display ID. If there are several IDs, they are separated by a semicolon ";"
displayNameFor display: display name.
camListFor monitor: IDs of cameras added to the monitor separated by semicolon ";"