题目支持媒体文件 - 前端对接文档
概述
content_media）和选项媒体（option_media）字段，支持题目和选项中附加图片/视频。| 字段 | 类型 | 说明 |
|---|---|---|
content_media | JSON 数组 | 题目内容的媒体文件列表 |
option_media | JSON 对象 | 各选项的媒体文件列表（key 为选项字母 A-G） |
{
"type": "image", // 固定值：image 或 video
"url": "https://xxx.com/file.jpg" // OSS 文件地址
}一、后台管理接口变更（题库管理）
说明： 以下接口为后台管理系统使用，用于题目的增删改查操作。
1.1 添加题目 /adminapi/exam.question_bank/add
{
"type": 1,
"cate_id": 106,
"content": "题目内容",
"answer_option": {"A": "选项A", "B": "选项B", "C": "选项C", "D": "选项D"},
"answer_correct": "A",
"content_media": [
{"type": "image", "url": "https://oss.example.com/question/img1.jpg"},
{"type": "video", "url": "https://oss.example.com/question/video1.mp4"}
],
"option_media": {
"A": [{"type": "image", "url": "https://oss.example.com/option/a.jpg"}],
"B": [{"type": "image", "url": "https://oss.example.com/option/b.jpg"}]
}
}| 字段 | 规则 |
|---|---|
content_media | 数组，每项必须包含 type(image/video) 和 url(非空字符串) |
option_media | 对象，key 为 A-G，value 为媒体数组，结构同 content_media |
content_media 格式错误，需为数组，每项包含 type(image/video) 和 urloption_media 的 key 'X' 不合法，仅支持 A-G1.2 编辑题目 /adminapi/exam.question_bank/edit
content_media 和 option_media 为选填参数。1.3 题目列表 /adminapi/exam.question_bank/lists
{
"id": 14875,
"type": 1,
"cate_id": 106,
"content": "题目内容测试",
"answer_option": {"A": "A..", "B": "bbbb", "C": "ccc", "D": "dddd"},
"answer_correct": "A",
"answer_parse": "",
"content_media": [
{"type": "image", "url": "https://oss.example.com/safety/scene_photo.jpg"}
],
"option_media": {
"A": [{"type": "image", "url": "https://oss.example.com/safety/no_helmet.jpg"}]
}
}content_media: []，option_media: {}二、小程序接口变更（考试相关）
说明： 以下接口为小程序端使用，用于考试、模拟考、错题本等场景。
2.1 开始考试 /adminapi/v2.exam.task_exam/startExam（新增 v2 版本）
/adminapi/exam.task_exam/startExam/adminapi/v2.exam.task_exam/startExam（新增）list 中每道题目新增字段：{
"list": [
{
"id": 14875,
"type": 1,
"content": "题目内容",
"answer_option": {"A": "选项A", "B": "选项B"},
"answer_correct": "A",
"answer_parse": "解析",
"content_media": [
{"type": "image", "url": "https://oss.example.com/question/img.jpg"}
],
"option_media": {
"A": [{"type": "image", "url": "https://oss.example.com/option/a.jpg"}]
}
}
]
}content_media 和 option_media 字段2.2 开始模拟考 /adminapi/v2.exam.taskExam/startMock
list 中每道题目新增字段：content_media 和 option_media 字段自动包含。2.3 阅卷/交卷 /adminapi/v2.exam.task_exam/scoring
error_questions（错题列表）中每道题目新增字段：{
"error_questions": [
{
"id": 14875,
"type": 1,
"content": "题目内容",
"answer_option": {"A": "选项A", "B": "选项B"},
"answer_correct": "A",
"answer_parse": "解析",
"content_media": [...],
"option_media": {...}
}
]
}2.4 查看试卷 /adminapi/v2.exam.task_exam/getExamPapers
list 中每道题目新增字段：content_media 和 option_media 字段自动包含。2.5 考试结果 /adminapi/v2.exam.task_exam/getResult
paper_list 中每道题目新增字段：content_media 和 option_media 字段自动包含。三、小程序接口变更（错题本）
说明： 以下接口为小程序端使用，用于错题本功能。
3.1 错题列表 /adminapi/exam.question_wrong/wrongList
list 中每道题目新增字段：q.* 查询，自动包含 content_media 和 option_media 字段。四、前端适配建议
4.1 后台管理 - 题目编辑页面
说明： 以下适配建议针对后台管理系统的题目编辑功能。
1.
2.
3.
4.
4.2 小程序 - 答题页面
说明： 以下适配建议针对小程序端的答题功能。
1.
2.
3.
五、接口变更汇总
| 接口 | 平台 | 变更类型 | 新增字段 |
|---|---|---|---|
/adminapi/exam.question_bank/add | 后台管理 | 新增参数 | content_media, option_media |
/adminapi/exam.question_bank/edit | 后台管理 | 新增参数 | content_media, option_media |
/adminapi/exam.question_bank/lists | 后台管理 | 新增返回字段 | content_media, option_media |
/adminapi/v2.exam.task_exam/startExam | 小程序 | 新增接口 | 题目包含 content_media, option_media |
/adminapi/v2.exam.taskExam/startMock | 小程序 | 新增返回字段 | 题目包含 content_media, option_media |
/adminapi/v2.exam.task_exam/scoring | 小程序 | 新增返回字段 | error_questions 中题目包含媒体字段 |
/adminapi/v2.exam.task_exam/getExamPapers | 小程序 | 新增返回字段 | 题目包含 content_media, option_media |
/adminapi/v2.exam.task_exam/getResult | 小程序 | 新增返回字段 | paper_list 中题目包含媒体字段 |
/adminapi/exam.question_wrong/wrongList | 小程序 | 新增返回字段 | 题目包含 content_media, option_media |
六、兼容性说明
1.
content_media: []，option_media: {}2.
3.
修改于 2026-06-14 13:00:03