Event Insertion
In addition to managing events that are generated by your Eagle Eye Cloud Surveillance system, there may be times when you need to report an event that was detected by an external system. For example, you may wish to create an event based on sensor data from smoke detectors or microphones. Or, you may wish to initiate an event when someone employed in your facility activates a panic alarm. By triggering an event, you will create a record in the cloud VMS that can be retrieved via the List Events
endpoint .
To create an event, you'll need to submit the event data to the Eagle Eye Networks REST API by sending a POST command to the [/api/v3.0/events](https://developer.eagleeyenetworks.com/v3.0/reference/createevent)
endpoint.Example of a device status event:
curl --request POST \
--url https://api.cxxx.eagleeyenetworks.com/api/v3.0/events \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"startTimestamp": "{{startTimestamp}}",
"endTimestamp": "{{endTimestamp}}",
"span": true,
"actorAccountId": "",
"actorId": "",
"actorType": "camera",
"creatorId": "unknown",
"type": "een.deviceCloudStatusUpdateEvent.v1"
}
'
Example of an intrusion event:
curl --request POST \
--url https://api.cxxx.eagleeyenetworks.com/api/v3.0/events \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"startTimestamp": "{{startTimestamp}}",
"endTimestamp": "{{endTimestamp}}",
"span": false,
"accountId": "",
"actorId": "",
"actorAccountId": "",
"actorType": "camera",
"creatorId": "",
"type": "een.objectIntrusionEvent.v1",
"dataSchemas": [
"een.intrusionArea.v1"
],
"data": [
{
"type": "een.intrusionArea.v1",
"id": "area789",
"name": "",
"area": [
[0.0, 0.0],
[1.0, 0.0],
[1.0, 1.0],
[0.0, 1.0]
]
}
]
}
To submit an event, you'll need to follow the formatting requirements we've provided. You can find examples of these event requests in this document.
Updated about 1 month ago