v2026.02.2
v2026.02.2의 복합 이벤트 응답, 임계값 수정 및 인증 변경 사항 안내입니다.
Summary
v2026.02.2에서는 복합 이벤트의 마이크 응답과 임계값 수정 동작이 변경되며, 타임스탬프 및 인증 오류의 발생 조건을 명확히 안내하도록 수정하였습니다.
Changed
- 복합 이벤트: 목록·단건·실시간 응답의
mics[]항목은 단일 마이크 조회 응답과 같은 9개 필드(id,name,host,edge_id,status,thresholds,location,created_at,updated_at)만 반환하도록 변경하였습니다. 나머지 필드는mics[]에서 제거되며, 중첩된events[].microphone객체는 바뀌지 않습니다. 구체적인 예시는 복합 이벤트 API 개요를 참고해 주세요. - 타임스탬프:
started_at에 최대 6자리 precision의 소수 초가 포함될 수 있습니다. 해당 값 사용 시 소수 초 유무와 관계없이 읽을 수 있는 ISO 8601 파서를 사용을 권장드립니다. - 마이크 수정: 마이크 수정은 전달한 임계값만 갱신하도록 변경하였습니다. 각 이벤트 종류의 값은
sound_level_ge(0 ~ 100)와confidence_ge(0 ~ 1)를 가진 객체입니다. 범위를 벗어나면 422, 지원하지 않는 이벤트 종류를 보내면message: 'This firmware SKU does not support the requested event classes'를 담은 400 응답을 반환하도록 추가하였습니다.. - 인증: Access Token을 발급한 세션이 종료되면 만료 시각 전에도 기존 만료된 토큰 401 응답을 반환하도록 수정했습니다. 비활성화된 계정은 기존 잘못된 토큰 401 응답을 반환합니다. 구체적인 내용은 인증을 참고해 주세요.