보관된 버전: v2025.08

보관된 레퍼런스 버전을 보고 있습니다.

최신 레퍼런스 보기릴리즈 노트

이벤트 목록 조회

모든 엣지 서버에서 수집된 이벤트 목록을 조회합니다.

마지막 업데이트: 1980년 1월 1일

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"
    }
  ]
}

요청 예제

Run In Postman

기본 요청

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();