Get

Function

This API is used to get parameter for Event > event check page.

Request Message

Event_push

POST: Request message see table 1
GET: Request message see table 20

Event_check

Table 1

Parameter	Range	Type	Description
reader_id		unsigned int	Optional, when not input, the board checks all alarm information and outputs readerID
sequence		unsigned int	Optional, when not input, the board checks all alarm information and outputs readerID
lap_number		unsigned int	Optional, when not input, the board checks all alarm information and outputs readerID
plus_eventchk	"eventAiPushPic"	string	Must bring, subscription required
ext_data		Json array	Subscription method needs to be taken, carry the type of client needs to subscribe, see table 1.1
subscribe_id		unsigned int	Current reader index
data_pos		unsigned int	Index of current reader read events

table 1.1

Parameter	Range	Type	Description
subscribe_type		Json Array	Subscription Type For the type of subscription required by the client, see table 1.2
unsubscribe_type		Json Array	Unsubscribed types Do not include certain types in already subscribed types, see table 1.2
snap_resolution	"640x480" "1280x720" "no_snapshot"	string	Optional event carry picture resolution，no_snapshot: Without chart

table 1.2

Parameter	Range	Type	Description
event	"all" "motion" "io" "videoloss" "videohide" "int" "sound_dectet"	Json Array	Ordinary event type
aipushpic	"all"	Json array	Intelligent tweet type

Sample:

POST /API/Event/Check
HTTP/1.1

{
    version": "1.0",
    "data": {
        "plus_eventchk": "eventAiPushPic",
        "ext_data": {
                        "subscribe_type": [{"event": ["all"]}]
                        },
        "reader_id": 1,
        "sequence": 9595,
        "lap_number": null
    }
}

Response Message

Parameter Description

Table 2

Parameter	Range	Type	Description
reader_id		int	Optional, when the request has no readerID, create a readerID and return it.
sequence		int	Current latest sequence position
lap_number		unsigned int	The number of laps the current sequence position belongs to
subscribe_record_sign		bool	Optional, the default is to subscribe to the recording flag .If the field passes true or does not pass this field, it means to subscribe to the recording flag, and if the field passes false, it means not to subscribe to the recording flag
subscribe_intelligence		bool	Optional, subscribe to smart alarm events by default.If the field passes true or does not pass this field, it means subscription, and if the field passes false, it means not to subscribe to the smart alarm event
alarm_list		Json array	Single alarm show as table
log_collect		Json Object	Optional. When the log collection NVR mode is enabled, you can push log messages table 23
heat_alarm	"HeatAlarm"	string	Optional, when there is no alarm_list, output heartbeat alarm message
videoloss_status		bool	Dynamically display the video loss logo
alarm_snap_data		Json array	For the image data carried by the event (event push is not supported by udp), see table 15
ai_snap_picture		Json object	Intelligent map data, see table 16
ccCount		Json array	Cc count statistics, see table 17
hmlist		json array	Heat map statistics, see table 18
device_name		string	devicename
dev_net_info		Json array	Device information, see table 19
system_alarm		Json array	Device alarm see table 3(optional)
channel_alarm		Json array	Single channel alarm see table 21(optional)
time		string	"MM/DD/YYYYhh:mm:ss"

Table 3

Parameter	Range	Type	Description
device_name	Max_length:31	string	Equipment name (optional)
hdd		json	See Table 4 (optional)

Table 4

Parameter	Range	Type	Description
hdd_alarm_type	"Ok","Error"	string	Hard disk alarm type
hdd_alarm_info	"Full" "Bad" "Unformat" "Readonly" "Warning" "NoDisk"	string	Hard disk error warning information

Table 5

Parameter	Range	Type	Description
channel		string
motion_alarm		bool	(optional)
record_flag		json	Video logo (optional) See Table 6
camera_connect_status		json	(optional)Table 7
io_alarm		bool	(optional)
pir_alarm		bool	(optional)
channel_name		string	(optional)
Floodlight_AudioAlarm		json	(optional)Table 8
ptz_alarm		json	(optional) Table 9
videoloss		bool	(optional)
int_alarm		Json Object	(optional)Table 10
alarm_state		Json array	(optional)Table 10
motion_smart_alarm		Json Object	Table 13
alarm_out_state		Json Array	(NVR/DVR) See Table 14
wireless_ipc_type		int	(wireless dedicated)Wireless IPC power supply type, battery 1, long-term power supply 2
remote_pair_state	Max_length:20	string	(wireless dedicated)Report the result of remote matching Pair success:paired successfully Pair fail:Pairing failed Timeout:time out Pair is not supported:pairing not supported
take_alarm_snap		unsigned int	Carry the id corresponding to the picture
chn_alias		string	For channel

Table 6

Parameter	Range	Type	Description
m	"R""G"	string	Motion Alarm "R":Alarm recording status "G":Alarm without recording state
i	"R""G"	string	IO Alarm "R":Alarm recording status "G":Alarm without recording state
p	"R""G"	string	PIR Alarm "R":Alarm recording status "G":Alarm without recording state
s	"R""G"	string	Intelligent Alarm "R":Alarm recording status "G":Alarm without recording state
r	"SR""MR"	string	Recording "SR":Alarm recording status,"MR":On-board manual recording status
h	"R"	string	SDcardAlarm "R":Hard disk alarm
c	"R""G"	string	VideoTampering "R":Alarm recording status "G":Alarm without recording state

Table 7

Parameter	Range		Type	Description
connect_status	"NotConfigured" "Online" "Offline" "Sleep" "NotPaired"		string	Channel connection status
ability	"Fisheye" "Binoculars" "Ptz" "NewPtz"（NVR/DVR Need not） "HkPtz" "Iris" "Mainstream" "Substream" "Mobilestream" "FloodLight" "AudioAlarm" "AlarmOutNum" "TalkHalf" "TalkFull" "Color" "RedBlueLight" "NotAutoReconnect" "Pir" "Cover"	string array
protocol	Max length: 15byte		string	IPC access protocol
input_num				Alarm input
output_num				Alarm Output
intelligent_ability	"CrossCount" "HeatMap" "SOD" "LCD" "PVD" "FD" "PID" "CrowdDensity" "LPD" "RSD" "QD" "AttributeDetect" "Intrusion" "RegionEntrance" "RegionExiting" "FireDetection" "TempMeas"

Table 8

Parameter	Range	Type	Description
floodlight_switch	true false	bool	White light real-time switch,false: close true: open
flood_light_value	1 - 100	int	Brightness of white light
floodlight_value_range	1 - 100	Object	White light brightness range
audioAlarm_switch	true false	bool	Horn real-time switch false: close true: open
audioAlarm_value	1 - 10	int	Speaker volume
audioAlarm_value_range	1 - 10	Object	Speaker volume range

Table 9

Parameter	Range	Type	Description
cur_zoom_value		int	Current position of zoom (temporarily unused)
zoom_step	0 - 2	int	0:1 step 1:5 Step 2:20 Step (temporarily unused)
cur_focus_value		int	Focus Current location (temporarily unused)
focus_step	0 - 2	int	0:1 Step 1:5 Step 2:20 Step (temporarily unused)
auto_focus_state		int	0:Focus ends,1:Focusing (temporarily unused)
shift_range		int	(temporarily unused)
ptz_cruise_state		bool	Preset point cruise state
ptz_line_scan_state		bool	Line scan cruise state

Table 10

Parameter	Range	Type	Description
alarm_val	true\|false	bool
int_subtype	video_tampersod lcd pid pd fd sound avd pd_vd cc cd qd lpd rsd ad intrusion region_entrance region_exiting fireDetect measure	string	"video_tamper":Video tampering alarm "sod":SOD object lost legacy "lcd":LCD cable alarm "pid":PID perimeter alarm "pd":PD human body "fd":FD face "sound":Sound alarm "avd":avd alarm "pd_vd":pd_vd alarm "cc":cc alarm "cd":Crowd Density Detection "qd":Queue length detection "lpd":license plate detection "rsd":Abnormal sound detection "ad":Face attribute "fireDetect"：flame detection "measure"：temperature measurement

Table 11

Error Code	Description
readerID_invalid
position_invalid

Table 12

Parameter	Range	Type	Description
channel	1 - 127	int	Intercom channel number
talkback_close	true\|false	bool	Whether to close the intercom
error_code	"localuser_operating_cannot_talkback" "localuser_close_talkback"	string	Intercom off reason localuser_operating_cannot_talkback:The user is in the setting interface localuser_close_talkback:User turns off intercom

Table 13

Parameter	Range	Type	Description
MDtime		string	"MM/DD/YYYYhh:mm:ss"
MDState		string array

Table 14

Parameter	Type	Description
Local->1	bool	Local->1 channel alarm switch
……		……
Local->x	bool	Local->x channel alarm switch
IP_CH1->1	bool	IP_CH1->1 channel alarm switch
……		……
IP_CHx->x	bool	IP_CHx->x channel alarm switch

Table 15

Parameter	Type	Description
chnnel	string	devicename
chn_alias	string	eventpush carry
img_id	int	The id that the picture carries
img_encode	string	Picture coding format
img_format	string	picture format
img_data	string	Picture data

Table 16

Parameter	Type	Description
Chn	int	devicename
strChn	string	devicename
Chn_alias	string	carry
StartTime	unsigned int	Picture coding format
EndTime	unsigned int	Picture end time
SnapId	int	Picture id
Type	int	Image type
ImageAllInfo	base64	智能推图除图片外的全部信息
ObjectImage	base64	Alarm graph
backGround	base64	background-image

Table 17

Parameter	Type	Description
channel	string	devicename
chn_alais	string	eventpush carry
cc_type	int	type
cc_objNum	int	cc alarm count
cc_version	int	version
ccin_num	int	cc entry quantity
ccout_num	int	cc outgoing quantity
cc_in_sum_num	int	cc enters total number
cc_out_sun_num	int	cc out total quantity

Table 18

Parameter	Type	Description
channel	string	devicename
chn_alais	string	eventpush carry
hm_type	int	type
map_num	int	number of alarm
hm_version	int	version number
hm_width	int	Thermogram width
hm_height	int	Heat map height
map_lens	int	length
hm_datatype	int	type of data
hm_objNum	int	Thermogram quantity
hm_img	string	Heat map image data

Table 19

Parameter	Type	Description
phy	string	the Ethernet card
ip	string	IP address
mac	string	mac address
ChnnelName	string	The name of the page setting

eventpush is pushed by GET

URL

GET {user defined in Event > Http_listening}?EventType=xx&EventTime=xx&EventAction=xx&MACAddress=xx
见 table 20

Table 20

Parameter	Range	Type	Description
EventType	"VideoMotion" "VideoBlind" "SoundDetect" "SOD" "LCD " "PID " "PD_VD" "FD" "CC" "AD" "CD" "QD" "LPD" "RSD"	string	IPC alarm type
EventTime		string	Alarm trigger time
EventAction	"start" "stop"	string	Alarm status of IPC
MACAddress		string	MAC address of IPC ，like D094662C1A8D

Table 21

Parameter	Range	Type	Description
channel		string	devicename
motion_report		json object	For the motion alarm parameters, see table 22

Table 22

Parameter	Range	Type	Description
alarm_state		bool	Report the motion alarm status to the remote. (Optional) true: start false: end
alarm_type	smd	string	Alarm type

Table 23

Parameter	Range	Type	Description
dir_name		string	Name of the log storage directory
file_name		string	Log file name

Sample1:
user defined url: /API/AlarmEvent/EventPush

GET /API/AlarmEvent/EventPush?EventType=VideoMotion&EventTime=2022-5-26 11:5:0&EventAction=start&MACAddress=5C-F2-07-49-0F-24 HTTP/1.1
Host: 172.16.8.63:123
Accept: */*
Content-Type: application/json;charset=UTF-8

Sample2:

POST /API/Event/Check?2020-10-17%2014:21:33 HTTP/1.1
Content-Type: application/json; charset=UTF-8
Accept: application/json, text/javascript, */*; q=0.01
X-csrftoken: 14559384d58d55d9d80bf4baf048684f366c77905d665d99ba1bde2cdcf81b08
Content-Length: 2438
Cookie: session=cc3ec99c6f1295489c86f8842e1dd719c194c637af5b965a23932c41188a3acc
{
version": "1.0",
    "data": {
        "plus_eventchk": "eventAiPushPic",
        "ext_data": {"subscribe_type": [{"event": ["all"]}]},
        "reader_id": 1,
        "sequence": 9595,
        "lap_number": null
    }
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2976
{
    "result": "success",
    "data": {
        "alarm_list": [{
            "time": "2023-08-25T08:38:58Z+08:00",
            "system_alarm": [{
                "device_name": "RS-CH281M8ND-DF-WA2812PW",
                "hdd": {
                    "hdd_alarm_type": "Error",
                    "hdd_alarm_info": "NoDisk"
                }
            }],
            "channel_alarm": [{
                "channel": "CH1",
                "record_flag": {"h": "R"}
            }]
        }],
        "log_collect": {
             "dir_name":"2023_07_04",
             "file_name": "20230704_211532_ch1.log.tar.gz"
         },
        "reader_id": 1,
        "sequence": 9596
    }
}

Error Code

See Response Messages Body and Common error_code for more information.

HTTP API Protocol For IP Media Device