How to use Events API

This article provides python samples and instructions on how to create events, trigger events, and view events in corresponding database

\uD83D\uDCD8 Instructions

Download python samples related to events API

Access tokens for cameras can be found on the integrations page of the VXG Cloud One web client.

Creating a Custom Event

Get camera’s access token
call camera api to get access token
From the directory containing the python samples, call cameras_create_custom_event.py to create a custom event.
```
python3 ./cameras_create_custom_event.py -a dfasdfasdfasrwecsdcsdf= -e test
```
Where -a is the camera’s access token and -e is the name of the new event being created.6.html#/servers/get_admin_servers_

Enabling Motion Detector Event

From the directory containing the python samples, call cameras_enable_motion_detector.py to enable motion detection events.
```
python3 ./cameras_enable_motion_detector.py -access_token dfasdfasdfasrwecsdcsdf= -enabled true
```
Where enabled is either true or false depending on if you would like to enable or disable motion detection.

How to Start and Stop Recording Events

To begin recording events call cameras_event_processing_events.py with the parameter record_stat=on.
```
python3 ./cameras_event_processing_events.py -access_token sdafasdfasdfasdfasdfasrwecsdcsdf= -ename motion -record_stat on
```
Where access_token is the camera’s access token and ename is the name of the event.
To stop recording events call cameras_event_processing_events.py with the parameter record_stat=off.
```
python3 ./cameras_event_processing_events.py -access_token sdafasdfasdfasdfasdfasrwecsdcsdf= -ename motion -record_stat off
```
Where access_token is the camera’s access token and ename is the name of the event.

How to View Event Records

Call storage_api_get_events.py to view recorded events within a specified time interval.

python3 ./storage_api_get_events.py -access_token sdafasdfasdfasdfasdfasrwecsdcsdf= -start 2022-12-01T08:30:00 -end 2022-12-02T08:30:00 -limit 10

Where access_token is the camera’s access token, start is the beginning of the time interval, end is the end of the time interval, and limit is the maximum number of events to include in response.
Event data is of shape:

{
  'camid': int,
  'id': int, 
  'name': str, 
  'thumb': {
    'height': int, 
    'id': int, 
    'size': int, 
    'time': 'str', 
    'url': str, 
    'width': int
  }, 
  'time': str
}

END