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 응답을 반환합니다. 구체적인 내용은 인증을 참고해 주세요.