# 新增接口文档 (前端兼容)

根据前端 `shudao-vue-frontend` 请求的定义，后端补充了以下缺失的接口，确保前后端能够正常通信。
这些接口已实现并在 `routers/new_apis.py` 中注册到 `22001` 端口服务上。

## 1. 保存考试
- **路径**: `/apiv1/save_exam`
- **方法**: `POST`
- **说明**: 对应前端 `saveExam` 请求，用于保存考试记录。

## 2. 获取考试历史
- **路径**: `/apiv1/get_exam_history`
- **方法**: `GET`
- **说明**: 对应前端 `getExamHistory` 请求，用于获取用户生成的考试记录历史。

## 3. 获取单次考试详情
- **路径**: `/apiv1/get_exam/{exam_id}`
- **方法**: `GET`
- **说明**: 对应前端 `getExamById` 请求，用于回显具体的考试内容。

## 4. 保存题目修改
- **路径**: `/apiv1/save_question_modification`
- **方法**: `POST`
- **说明**: 对应前端 `saveQuestionModification` 请求，用于考试工坊中保存特定题目的手动修改记录。

## 5. 获取PPT结构JSON
- **路径**: `/apiv1/get_ppt_json`
- **方法**: `POST`
- **说明**: 对应前端 `getPPTJson` 请求，用于将上传的 PPT 文件解析并返回对应的 JSON 大纲结构。

## 6. 获取历史记录（对话列�? / 消息详情�?
- **路径**: `/apiv1/get_history_record`
- **方法**: `GET`
- **说明**: 
  - `ai_conversation_id=0` ：返回对话列表、ࣺ`data` �� `id/title/content/business_type/exam_name/created_at/updated_at`�������� `total`��
  - `ai_conversation_id>0` ：返回该对话的消息详情列表、ࣺ`data` �� `id/ai_conversation_id/user_id/type/content/user_feedback/prev_user_id/search_source/guess_you_want/created_at/updated_at`��

## 7. 删除对话（按对话 / ��AI��Ϣ��
- **路径**: `/apiv1/delete_conversation`
- **方法**: `POST`
- **说明**:
  - `ai_conversation_id` ��ֵʱ����ɾ�����ζԻ�������Ϣ��
  - `ai_message_id` ��ֵʱ����ɾ��ָ�� AI ��Ϣ����ͬʱɾ�����Ӧ����һ���û���Ϣ��