실시간 이벤트 수신
WebSocket으로 실시간 이벤트를 수신하는 방법을 설명합니다.
마지막 업데이트: 1980년 1월 1일
Live Events API는 Deeply 시스템이 감지한 오디오 이벤트를 실시간 데이터 스트림으로 제공합니다. 이 API는 WebSocket 연결을 사용해 이벤트 데이터를 지속적으로 스트리밍하므로, 클라이언트는 이벤트가 발생하는 즉시 모니터링할 수 있습니다.
WebSocket 엔드포인트
WebSocket
/api/v1/ws/events인증
WebSocket 연결을 생성할 때 헤더에 Bearer 토큰 형태의 API key를 포함해야 합니다.
쿼리 파라미터
mic_id
Optional
string
특정 마이크 ID에 해당하는 이벤트를 필터링합니다.
이벤트 메시지 형식
WebSocket 연결을 통해 수신되는 메시지는 아래 구조를 따릅니다:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
"id": "string",
"label": {
"id": "string",
"name": {
"ko": "string",
"en": "string"
}
},
"confidence": 0,
"mic": {
"id": "string",
"name": "string",
"location": {
"latitude": 0,
"longitude": 0
}
},
"created_at": "2024-01-01T00:00:00Z",
"updated_at": "2024-01-01T00:00:00Z",
"noises": [
0
]
}예시 메시지
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
{
"id": "23d6ec74155f4eb187b4e7301b71b5d9",
"label": {
"id": "normal_speech_female",
"name": {
"ko": "대화(여성)",
"en": "normal speech female"
}
},
"confidence": 0.426632,
"mic": {
"id": "d00c8e3364a34439183e3462e773354a1",
"name": "Example Mic (715)",
"location": {
"latitude": 37.546344,
"longitude": 126.944322
}
},
"noises": [
66.99,
65.28,
68.21,
68.12,
67.56,
70.66,
67.35,
63.42,
59.98,
64.05,
65.86,
62.88,
62.41,
62.59,
61.96,
59.25,
58.16,
59.75,
64.2,
65.15
]
}