Get

Function

This API is used to get parameter for Event > Http listening page.

Request Message

Parameter Description

Table 1

ParameterRangeTypeDescription
paramsJson ObjectSingle Channel Information JSON show as followTable 2

Table 2

ParameterRangeTypeDescription
name0,127stringchannel number
tableJson ObjectSingle Channel Information JSON show as followTable 3

Table 3

ParameterRangeTypeDescription
usernamestringUsername, or empty if none
passwordstringPassword
addrstringserver address
port1-65535intserver port
url0-128stringServer api interface, if not empty
enabletrue, falseboolAlarm push function switch
methodGET
POST
StringHTTP push type
keep_alive_intervalOFF
1min
5min
10min
Stringkeepalive interval
push_wayHTTP
UDP
stringpush method
udp_methodUnicast
Multicast
Broadcast
stringUDP push type
udp_addrstringUDP server address
udp_port1-65535intUDP server port

Sample:

POST /API/AlarmConfig/EventPush/Get HTTP/1.1
{
    "version": "1.0",
    "data": {}
}

Response Message

Parameter Description

Table 4

ParameterRangeTypeDescription
EventTypeVideoMotion
VideoBlind
SoundDetect
SOD
LCD
PID
PD_VD
FD
CC
AD
CD
QD
LPD
RSD
stringIPC alarm type
EventTimestringAlarm trigger time
EventActionStart
stop
stringAlarm status of IPC
ChannelNamestringchannel name
DeviceNamestringIPC device name
IPAddressstringIP address of the IPC
MACAddressstringIPC MAC address
PicDataJson ObjectThe push data when the smart alarm is sent, as shown in the Table 5 below

Table 5

ParameterRangeTypeDescription
SnapedObjInfotJson ObjectPush data when Pd&vd, PID, LCD intelligent alarm, as shown in the Table 6 below
PlateInfoJson ObjectPush data when LPD intelligent alarm, as shown in the table Table 7 below
FaceInfoJson ObjectThe push data when FD intelligent alarm is shown in the Table 8 below

Table 6

ParameterRangeTypeDescription
Chn0intIPC only uses channel 0
StrChn"CH1"stringchannel name
StartTimelong longstart time, picture with
EndTimelong longend time, picture with
SnapIdintimage id
Typeinttype ACPT_Face = 0,
ACPT_HumanBody = 1,
ACPT_Vehicle = 2,
ACPT_PIDHumanBody = 3,
ACPT_PIDVehicle = 4,
ACPT_LCDHumanBody = 5,
ACPT_LCDVehicle = 6,
ObjectImagestringBase64 encoded image data
BackgroundstringBase64 encoded background image data

Table 7

ParameterRangeTypeDescription
Id1-15charactersstringLicense plate number, unique identification.
GrpIdintgroup ID
SnapIdunsigned intThe Id of the picture when the front-end IPC captures
Type0intTypes of face capture objects
StrChnstringchannel
StartTimeunsigned long longSnapshot start time, such as: 2018-10-25 13:08:36, Unix timestamp (displayed according to UTC time zone uniformly)
EndTimeunsigned long longThe capture end time, such as: 2018-10-25 13:08:46, Unix timestamp (when displayed, it will be displayed uniformly in UTC time zone)
BgImgWidthunsigned intCapture the width of the picture
BgImgHeightunsigned intCapture the height of the picture
Chnintchannel
PlateColor0-5intLicense plate color, the possible values are as follows:
enum AIPlateColor_e {
    APC_Blue = 0,// blue
    APC_Green = 1,// green
    APC_Yellow = 2,// yellow
    APC_Black = 3,// black
    APC_White = 4,// White
    APC_Other = 5,// other colours
    APC_Max
};
CarBrandstringcar brand
CarTypestringcar model
SexintOwner gender: 0-male, 1-female
Owner"Mike"stringowner name
IdCode"415025199203050916"stringidentification number
Job"Software"stringProfession
Phone"12345678902"stringtelephone number
Domicile"Guangdong,Zhuhai,Xiangzhou ..."stringLiving
Remark"Detail of this person ..."stringRemark
ImageAllInfostringLicense plate picture information
PlateImg"base64(imgData)"stringlicense plate image
BgImg"base64(imgData)"stringBackground picture

Table 8

ParameterRangeTypeDescription
IdintFace Id, unique identification (nvr only)
GrpIdintGroup Id (nvr only)
SnapIdunsigned intThe Id of the picture when the front-end IPC captures
MD5stringMD5 value of the face image
Type0intTypes of face capture objects
StartTimeunsigned long longSnapshot start time, such as: 2018-10-25 13:08:36, Unix timestamp (displayed according to UTC time zone uniformly)
EndTimeunsigned long longThe capture end time, such as: 2018-10-25 13:08:46, Unix timestamp (when displayed, it will be displayed uniformly in UTC time zone)
BgImgWidthunsigned intCapture the width of the picture
BgImgHeightunsigned intCapture the height of the picture
ScoreintImage Score (Confidence)
SexintGender: 0-male, 1-female
Ageintage
GenderintFace attribute gender: 0-male, 1-female
Beautyintface score
fAttrAgeintface attribute age
GlassesTypeintGlasses type, 0: no glasses, 1: wear glasses (currently there is no distinction between sunglasses and ordinary glasses, all glasses are defaulted)
ExpressionintExpression type, 0: no expression, 1: smiling, 2: laughing
MouthMaskintWhether to wear a mask, 0: no mask, 1: with a mask
RaceintRace, 0: Yellow, 1: Caucasian, 2: Black, 3: Arab
Chnintchannel
StrChn“CH1”…”CH1x”
“IP_CH1”…” IP_CH1x”
“WIFI_CH1”…”
WIFI_CH1x”

The number of channels depends on the capabilities of the device.
stringchannel
Similarityfloatsimilarity
ModifyCntintThe number of revisions, the upper layer is read-only, and is updated in real time by the device every time the face information is modified (nvr only)
ImageAllInfostringpicture information
Image1"base64(imgData)"stringImported ID photo
Image2"base64(imgData)"stringCapture face pictures
Image3"base64(imgData)"stringA snapshot of the human body
Image4"base64(imgData)"stringCapture background image
Name"Mike"stringName (for nvr only)
Country"China"stringNationality (nvr only)
Nation"Han"stringEthnic (nvr only)
NativePlace"Guangdong,Zhuhai"stringHometown (nvr only)
IdCode"415025199203050916"stringID card (nvr only)
Job"Software"stringwork (nvr only)
Phone"12345678902"stringPhone (nvr only)
Email"abcd@163.com"stringMail (for nvr only)
Domicile"Guangdong,Zhuhai,Xiangzhou ..."stringCurrent residence (nvr only)
Remark"Detail of this person ..."stringEvaluation (for nvr only)
Feature"base64(imgData)"stringeigenvalue
FtVersionintFeature value version, it is meaningful only when comparing feature values with the same version, if return feature value, please return this field

Sample:

HTTP/1.1 200 OK
Content-Type: application/json
{
    "result": "success",
    "data": {"params": {
        "name": "",
        "table": {
            "username": "",
            "password": "",
            "password_empty": true,
            "addr": "",
            "port": 123,
            "url": "API/AlarmEvent/EventPush",
            "enable": false,
            "method": "POST",
            "keep_alive_interval": "0",
            "push_way": "HTTP",
            "udp_method": "Broadcast",
            "udp_addr": "",
            "udp_port": 5000
        }
    }}
}

Error Code

See Response Messages Body and Common error_code for more information.