HUTAMS_AUDIO/docs/api_contract.md

19 lines
942 B
Markdown

# WebSocket Events
모든 실시간 통신은 `/api/v1/ws/live` 엔드포인트에서 이뤄집니다.
1. **`stt_result`**: 오디오 변환 완료 즉시 발생.
- Payload: Pydantic `STTResponse` JSON
- 긴급도(`urgency`), 열번(`train_number`), 세그먼트 데이터 포함.
2. **`thread_updated`**: 병목이 걸리는 백그라운드 LLM 연산 처리 이후 보내지는 후행 이벤트.
- Payload: `{"action": "append|new", "record_id": num, "segment_id": num, "speaker": str}`
3. **`context_discovered`**: 관제 전문 지식이 포함되어 있을 경우 딕셔너리 정보 반환.
- Payload: `contexts` 배열 (키워드, 제목, 설명글 등)
# REST API
1. **`GET /api/v1/segments/{segment_id}/audio`**: Opus 압축 오디오 재생 스트리밍
2. **`GET /api/v1/records`**: STT 변환 이력 목록 조회
3. **`GET /api/v1/segments/daily`**: 일자별 세그먼트 채팅뷰 커서 페이징 조회