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. 복합 이벤트
    3. 단일 복합 이벤트 조회

    단일 복합 이벤트 조회

    복합 이벤트 ID로 특정 복합 이벤트를 조회합니다.

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

    도입 버전 v2026.02.1
    변경 버전 v2026.02.2
    GET
    /api/v1/composite-events/{composite_event_id}

    설명

    복합 이벤트 ID를 기준으로 특정 복합 이벤트를 조회하는 API입니다. 응답에는 복합 이벤트 규칙, 그룹화된 기본 이벤트, 관련 마이크, 라벨 정보가 함께 포함됩니다. 복합 이벤트 객체를 참고하면 관련 구조를 자세히 확인할 수 있습니다.

    인증

    Access Token은 Bearer 토큰 인증 방식으로 전달해야 합니다. 자세한 내용은 인증 문서를 참고해 주세요.

    경로 파라미터

    composite_event_id
    Required
    string
    복합 이벤트의 고유 식별자

    응답

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95
    96
    97
    98
    99
    100
    101
    102
    103
    104
    105
    106
    107
    108
    109
    110
    111
    112
    113
    114
    115
    {
      "id": "composite_evt_123",
      "group_key": "edge-01:normal_speech_female",
      "rule": {
        "id": "rule_001",
        "name": "Repeated Speech Cluster",
        "description": "Groups repeated speech events within the same window",
        "window_seconds": 30,
        "min_events": 3,
        "enabled": true,
        "group_by": "label_id",
        "include_label_ids": [
          "normal_speech_female"
        ],
        "include_mic_ids": [
          "mic_001",
          "mic_002"
        ]
      },
      "events": [
        {
          "id": "evt_001",
          "confidence": 0.93,
          "confidence_threshold": 0.5,
          "sound_level": 71.2,
          "sound_level_threshold": 65,
          "description": "Repeated speech detected near entrance",
          "audio_file": {
            "file_path": "/audio/events/evt_001.wav"
          },
          "is_read": false,
          "read_at": null,
          "created_at": "2026-03-26T09:00:00Z",
          "updated_at": "2026-03-26T09:00:05Z",
          "label_id": "normal_speech_female",
          "mic_id": "mic_001",
          "label": {
            "id": "normal_speech_female",
            "name": {
              "ko": "female speech",
              "en": "normal speech female"
            },
            "active": true
          },
          "microphone": {
            "id": "mic_001",
            "name": "Entrance Mic",
            "host": "172.16.10.21",
            "subnet_mask": "255.255.255.0",
            "mac_address": "00:11:22:33:44:55",
            "microphone_type": "PDM_715IP",
            "channel": {
              "scheme": "rtsp",
              "port": 554,
              "path": "/stream",
              "username": null,
              "password": null
            },
            "console": {
              "scheme": "http",
              "port": 80,
              "path": "/",
              "username": "admin",
              "password": "password"
            },
            "streaming": true,
            "recording": true,
            "edge_id": "edge_001",
            "location": {
              "latitude": 37.546344,
              "longitude": 126.944322
            },
            "status": "active",
            "thresholds": {},
            "created_at": "2026-03-01T00:00:00Z",
            "updated_at": "2026-03-26T09:00:05Z",
            "deleted_at": null,
            "reported_at": "2026-03-26T09:00:05Z",
            "connected": true
          }
        }
      ],
      "mics": [
        {
          "id": "mic_001",
          "name": "Entrance Mic",
          "host": "172.16.10.21",
          "edge_id": "edge_001",
          "status": "active",
          "thresholds": {
            "breathing_heavily": {
              "sound_level_ge": 65,
              "confidence_ge": 0.8
            }
          },
          "location": {
            "latitude": 37.546344,
            "longitude": 126.944322
          },
          "created_at": "2026-03-01T00:00:00Z",
          "updated_at": "2026-03-26T09:00:05Z"
        }
      ],
      "labels": [
        {
          "id": "normal_speech_female",
          "name": {
            "ko": "female speech",
            "en": "normal speech female"
          },
          "active": true
        }
      ],
      "started_at": "2026-03-26T08:59:45Z"
    }

    요청 예제

    1
    2
    3
    4
    5
    6
    7
    8
    const response = await fetch('http://{{EDGE_IP}}:8100/api/v1/composite-events/composite_evt_123', {
      method: 'GET',
      headers: {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    });
    
    const data = await response.json();
    복합 이벤트 목록 조회
    실시간 복합 이벤트 수신
    설명인증응답요청 예제