단일 복합 이벤트 조회

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

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

도입 버전 v2026.02
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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
{
  "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",
      "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"
      },
      "location": {
        "latitude": 37.546344,
        "longitude": 126.944322
      },
      "streaming": true,
      "recording": true,
      "status": "active",
      "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,
      "edge_id": "edge_001",
      "edge_status": "active"
    }
  ],
  "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();