Deeply API 문서 main logoDeeply API 문서 main logo textDeeply API 문서 main logo text
사용자 가이드서버 API 레퍼런스
검색...
k
언어ENKO

© 2026 Deeply Inc.

Deeply Logo Icon

Deeply API 문서

    릴리즈 노트

    빠른 시작

    API 빠른 시작
    인증
    호출 제한

    아키텍처

    전체 아키텍처
    엣지 서버 시스템

    이벤트

    이벤트
    이벤트 카테고리
    이벤트 목록 조회
    GET
    단일 이벤트 조회
    GET

    복합 이벤트

    복합 이벤트
    복합 이벤트 목록 조회
    GET
    단일 복합 이벤트 조회
    GET
    실시간 복합 이벤트 수신
    WebSocket

    실시간 이벤트

    실시간 이벤트
    실시간 이벤트 수신
    WebSocket

    엣지 서버

    엣지 서버
    엣지 서버 목록 조회
    GET
    단일 엣지 서버 조회
    GET
    엣지 서버 수정
    PATCH

    마이크

    마이크 장치
    마이크 목록 조회
    GET
    단일 마이크 조회
    GET
    마이크 수정
    PATCH

    인증

    토큰 재발급
    GET
    1. 레퍼런스
    2. 이벤트

    이벤트 API 개요

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

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

    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 형식을 사용합니다.

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

    엣지 서버 시스템
    이벤트 카테고리
    이벤트 객체속성idlabellabel.idlabel.nameconfidencemiccreated_atupdated_at