이벤트 목록 조회
모든 엣지 서버에서 수집된 이벤트 목록을 조회합니다.
GET
/api/v1/events설명
모든 엣지 서버에서 수집된 이벤트 목록을 조회하는 API입니다. 결과는 전달한 쿼리 파라미터를 기준으로 페이지네이션됩니다. 이벤트 객체를 참고하면 관련 구조를 자세히 확인할 수 있습니다.
인증
Access Token은 Bearer 토큰 인증 방식으로 전달해야 합니다. 자세한 내용은 인증 문서를 참고해 주세요.
쿼리 파라미터
page
Optional
integer ||
1페이지네이션을 위한 페이지 번호
(0보다 커야 함)size
Optional
integer ||
10페이지당 항목 수
(0보다 크고 101보다 작아야 함)start
Optional
string (datetime) ||
null이벤트 필터링 시작 시각
(ISO 8601 형식)end
Optional
string (datetime) ||
null이벤트 필터링 종료 시각
(ISO 8601 형식)mic_id
Optional
string ||
null마이크 ID로 이벤트를 필터링합니다. 여러 mic ID를 조회하려면 같은 쿼리 파라미터를 반복해서 전달하세요.
label_id
Optional
string ||
null라벨 ID로 이벤트를 필터링합니다. 여러 label ID를 조회하려면 같은 쿼리 파라미터를 반복해서 전달하세요.
응답
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
{
"page": 1,
"size": 10,
"total_cnt": 100,
"max_page": 10,
"results": [
{
"id": "string",
"label": {
"id": "string",
"name": {
"ko": "string",
"en": "string"
}
},
"confidence": 0,
"mic": {
"id": "string",
"name": "string",
"location": {
"latitude": -33.75,
"longitude": 151.25
}
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
]
}요청 예제
기본 요청
1
2
3
4
5
6
7
8
const response = await fetch('http://{{EDGE_IP}}:8100/api/v1/events?page=1&size=10', {
method: 'GET',
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});
const data = await response.json();시간 범위 요청
1
2
3
4
5
6
7
8
const response = await fetch('http://{{EDGE_IP}}:8100/api/v1/events?page=1&size=10&start=2024-01-01T00:00:00Z&end=2024-01-31T23:59:59Z', {
method: 'GET',
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});
const data = await response.json();mic_id / label_id 필터 요청
1
2
3
4
5
6
7
8
const response = await fetch('http://{{EDGE_IP}}:8100/api/v1/events?page=1&size=10&mic_id=example_mic_id&label_id=normal_speech_female', {
method: 'GET',
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});
const data = await response.json();여러 mic_id 요청
1
2
3
4
5
6
7
8
const response = await fetch('http://{{EDGE_IP}}:8100/api/v1/events?page=1&size=10&mic_id=example_mic_id1&mic_id=example_mic_id2', {
method: 'GET',
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});
const data = await response.json();