이벤트 API 개요

이벤트 API와 이벤트 객체 구조를 설명합니다.

마지막 업데이트: 2026년 3월 26일

Event ObjectEvent Stream in Deeply System

이벤트 객체

Event 객체는 오디오 모니터링 시스템에서 엣지 서버가 감지한 특정 이벤트를 나타냅니다. 예를 들어 특정 라벨로 분류된 소리와 그에 대한 신뢰도 점수가 함께 포함됩니다. 이 객체에는 이벤트 메타데이터, 관련 오디오 파일, 소리를 기록한 마이크의 상세 정보가 포함됩니다.

속성

id

  • Type: string
  • Description: 이벤트의 고유 식별자입니다.

label

  • Type: object
  • Description: 이벤트에 할당된 라벨 정보입니다.

label.id

  • Type: string
  • Description: 라벨의 고유 ID입니다.

label.name

  • Type: object
  • Description: 라벨의 다국어 이름입니다.
    • ko (string): 한국어 이름.
    • en (string): 영어 이름.

confidence

  • Type: float
  • Description: 이벤트가 해당 라벨에 속할 가능성을 나타내는 신뢰도 점수(0.0~1.0)입니다. 소수점 여섯 자리까지 표시됩니다.

mic

  • Type: object
  • Description: 해당 이벤트를 기록한 마이크 정보입니다.
    • id (string): 마이크의 고유 식별자입니다.
    • name (string): 마이크 이름입니다.
    • location (object): 마이크의 지리적 위치입니다.
      • latitude (number): 위도 좌표 (-90 to 90).
      • longitude (number): 경도 좌표 (-180 to 180).

created_at

  • Type: string, ISO 8601 format
  • Description: 이벤트가 생성된 시각입니다. ISO 8601 형식을 사용합니다.

updated_at

  • Type: string, ISO 8601 format
  • Description: 이벤트가 마지막으로 업데이트된 시각입니다. ISO 8601 형식을 사용합니다.

상세 응답은 단일 이벤트 조회 문서를 참고해 주세요.