Forward Event
To integrate EVA’s AI detection results with external systems, you can use the Forward function in the System settings to send event data via an HTTP API.
This feature enables the use of all situations and analysis results detected by EVA in other integrated management systems (VMS) or business applications.
External API Integration Settings
In the System settings, register the HTTP API address of the external system that will receive events. Whenever EVA detects a situation, you can configure it to send the following detailed information in JSON format to the specified API.
Event Data Structure (JSON)
| Field Name | Description | Example Data |
|---|---|---|
device | Unique sequence ID of the device (camera) registered in EVA | 1234 |
device_source | Camera streaming address (URL) | rtsp://... |
event_time | Exact timestamp when the event was detected | 2025-10-12T03:00:00Z |
vision_model | Name of the Vision ML model used for detection | helmet_detection_v2 |
detect_target | List of names of detected objects | ['person', 'car', 'person'] |
detect_count | Total number of detected objects | 3 |
confidences | List of confidence scores for detected objects | [0.98, 0.95, 0.88] |
phrases | Situational description phrases generated by LLM/VLM | ['No helmet worn', 'Left designated area'] |
llm_model | Name of the LLM model used for situation analysis | genmma3 |
alert | Severity of the alarm or image-based warning message | True |
message | Final situation analysis message determined by AI | A worker entered a hazardous area without wearing a helmet. |
image_data | Base64-encoded snapshot image data | (Base64-encoded string) |
Transmission Option Settings
You can flexibly configure the transmitted data and method to meet the requirements of the external API.
- Authorization: If the API call requires additional authorization headers, such as a Token, you can include this information to securely transmit data.
- Image Data Control:
- Exclude: If it’s unnecessary to receive images directly via the API or if you need to reduce data transmission load, you can configure the
image_datafield to be excluded from transmission. - Resolution Adjustment: When image transmission is required, you can configure the image resolution to be lowered to save network bandwidth.
- Exclude: If it’s unnecessary to receive images directly via the API or if you need to reduce data transmission load, you can configure the