Webhook API
EVA의 AI 탐지 결과를 외부 시스템과 연동해야 할 경우, System 셋팅의 Forward 기능을 사용하여 HTTP API로 이벤트 데이터를 전송할 수 있습니다.
이 기능은 EVA가 탐지한 모든 상황과 분석 결과를 다른 통합 관제 시스템(VMS)이나 비즈니스 애플리케이션에서 활용할 수 있게 합니다.
카메라 별 Webhook API 설정
EVA에서 지정된 위험 상황이 탐지되면, 관리자에게 즉시 알람을 전송하여 신속한 대응을 가능하게 합니다.
EVA는 널리 사용되는 협업 툴인 Teams 또는 Slack의 Webhook 기능을 통한 알람 전송을 지원합니다.
- Webhook 주소 생성: 알람을 수신하고자 하는 Teams 또는 Slack 애플리케이션 내에서 Webhook 주소를 생성합니다. (Webhook 생성에 대한 자세한 방법은 각 애플리케이션의 공식 매뉴얼을 참조하십시오.)
- EVA에 등록: EVA의 알람 설정 페이지에서 생성된 Webhook 주소를 등록합니다. 여러 개의 Webhook을 등록하여 알람을 역할별 또는 중요도별로 분류하여 전송할 수 있습니다.
- 알람 수신 내용: 알람이 발생할 때마다 Webhook을 통해 탐지된 상황에 대한 메시지, EVA가 판단한 상세 상황 설명, 그리고 관련 이미지 스냅샷이 첨부되어 제공됩니다.
App Webhook API 설정
System 셋팅에서 이벤트(EVENT)를 수신할 외부 시스템의 HTTP API 주소를 등록합니다. EVA에서 상황이 탐지될 때마다 해당 API로 다음의 상세 정보가 JSON 형태로 전송되도록 설정할 수 있습니다.
전송되는 이벤트 데이터 구조 (JSON)
| 필드명 | 설명 | 예시 데이터 |
|---|---|---|
device | EVA에 등록된 디바이스(카메라)의 고유 시퀀스 ID | 1234 |
device_source | 카메라의 스트리밍 주소 (URL) | rtsp://... |
event_time | 이벤트가 탐지된 정확한 시간 (타임스탬프) | 2025-10-12T03:00:00Z |
vision_model | 탐지에 사용된 Vision ML 모델의 이름 | helmet_detection_v2 |
detect_target | 탐지된 객체들의 이름 목록 | ['person', 'car', 'person'] |
detect_count | 탐지된 객체의 총 개수 | 3 |
confidences | 탐지된 객체들의 신뢰도 점수 목록 | [0.98, 0.95, 0.88] |
phrases | LLM/VLM이 생성한 상황 설명 문구 | ['안전모 미착용', '지정 구역 이탈'] |
llm_model | 상황 분석에 사용된 LLM 모델 이름 | genmma3 |
alert | 알람의 심각도 또는 이미지 기반 경고 메시지 | True |
message | AI가 최종적으로 판단한 상황 분석 메시지 | 작업자가 안전모를 착용하지 않고 위험 구역에 진입했습니다. |
image_data | Base64 인코딩된 스냅샷 이미지 데이터 | (Base64 인코딩된 문자열) |
전송 옵션 설정
외부 API의 요구사항에 맞춰 전송되는 데이터와 방식을 유연하게 설정할 수 있습니다.
- 인증(Authorization): API 호출에 Token과 같은 추가적인 Authorization 헤더가 필요한 경우, 해당 정보를 기입하여 안전하게 데이터를 전송할 수 있습니다.
- 이미지 데이터 제어:
- 제외: Image를 API로 직접 수신하는 것이 불필요하거나, 데이터 전송 부하를 줄여야 하는 경우
image_data필드를 전송에서 제외하도록 설정할 수 있습니다. - 해상도 조정: 이미지 전송이 필요한 경우에도, 네트워크 대역폭을 절약하기 위해 전송되는 이미지의 해상도를 낮춰서 전송하도록 설정할 수 있습니다.
- 제외: Image를 API로 직접 수신하는 것이 불필요하거나, 데이터 전송 부하를 줄여야 하는 경우