1.课堂练习列表查询
通过该接口可以获取课堂练习数据, 地址为:
https://spark.bokecc.com/api/exercise/list
需要传递以下参数:
参数 | 说明 |
---|---|
userid | ⽤户 id,不可为空 |
videoid | 视频 id,不可为空 |
返回字段含义如下:
参数 | 说明 |
---|---|
id | 练习id |
title | 练习名称 |
appeartime | 练习出现的时间 |
isjump | 是否允许跳过 (0否 ,1是) |
isplay | 是否允许继续播放(0否 ,1是) |
backsecond | 回看时间点 |
返回信息如下:
{
"result": "OK",
"exercises": [
{
"id": "F3CEA9F3FF0D306F",
"title": "课堂练习一",
"appeartime": 10,
"isjump": 0,
"isplay": 1,
"backsecond": 8
},
{
"id": "F3CEA9F3FF0D306W",
"title": "课堂练习二",
"appeartime": 11,
"isjump": 1,
"isplay": 1,
"backsecond": 8
}
]
}
2.课堂练习新增
通过该接口可以为增加课堂练习数据, 地址为:
https://spark.bokecc.com/api/exercise/create
需要传递以下参数:
参数 | 说明 |
---|---|
userid | ⽤户 id,不可为空 |
videoid | 视频 id,不可为空 |
title | 练习题目,不可为空 |
appeartime | 练习出现的时间,不可为空 |
isjump | 是否允许跳过 (0否 ,1是) |
isplay | 是否允许继续播放(0否 ,1是) |
backsecond | 回看时间点(isplay=0时,backsecond必须有值) |
| questions | 课堂练习存在至少一道题,示例代码如下|
[
{
"type": 0,
"content": "选择题",
"explaininfo": "WEQEWQE",
"backsecond": 5,
"answers": [{
"content": "选项一",
"isright": 0
}, {
"content": "选项二",
"isright": 1
}
]
},{
"type": 0,
"content": {
"before": "横线前",
"after": "横线后"
},
"backsecond": 5,
"explaininfo": "WEQEWQE",
"answers": [{
"content": "答案",
"isright": 1
}
]
}
]
字段questions中各字段含义如下
参数 | 说明 |
---|---|
type | 题目类型(0单选, 1多选, 2填空),不可为空 |
content | 题目内容,限长80字,不可为空 (填空题 格式{“before”:”1’,”after”:”2”} 翻译为before__after) |
backsecond | 回看时间点,可为空为空时,和课堂练习的backsecond保持一致 |
| explaininfo | 解析,限长500字 | | answers | 答案(单选多选最少两个答案,最多八个答案,填空一个答案) 问题的答案以及是否正确,不可为空,(该字段数据类型为 jsonArray,最 少2个最多8个选项,从上到下对应A-H),不可为空,示例如下 |
[
{
"content": "选项1",
"isright": 1
}, {
"content": "选项二",
"isright": 0
}
]
字段answers中各字段含义如下
参数 | 说明 |
---|---|
content | 答案内容,单选多选限长50字,填空限长20字,不可为空 |
isright | 是否正确(否 0,是1,填空题默认为1),不可为空 |
注:
一个时间点只能有一个练习
课堂练习中至少存在一个题目
一个视频最多20个练习
返回信息如下
{
“result”:”OK”,
“exerciseid”:”F3CEA9F3FF0D306F”
}
返回字段含义如下
参数 | 说明 |
---|---|
exerciseid | 练习id |
3.课堂练习编辑
通过该接口可以编辑课堂练习数据, 地址为:
https://spark.bokecc.com/api/exercise/update
需要传递以下参数:
参数 | 说明 |
---|---|
userid | ⽤户 id,不可为空 |
videoid | 视频 id,不可为空 |
exerciseid | 练习id,不可为空 |
title | 练习题目,限长80字,不可为空 |
appeartime | 练习出现的时间,不可为空 |
isjump | 是否允许跳过 (0否 ,1是) |
isplay | 是否允许继续播放(0否 ,1是) |
backsecond | 回看时间点(isplay=0时,backsecond必须有值) |
questions | 示例如下 |
[{
"questionid": "8D2FE8CDD3CE6472",
"type": 0,
"content": "选择题",
"explaininfo": "解析",
"backsecond": 5,
"answers": [{
"content": "选项一",
"isright": 0
}, {
"content": "选项二",
"isright": 0
}
]
},{
"type": 0,
"content": {
"before": "横线前",
"after": "横线后"
},
"explaininfo": "解析",
"backsecond": 5,
"answers": [{
"content": "选项一",
"isright": 1
}
]
}
]
字段questions中各字段含义如下,
参数 | 说明 |
---|---|
questionid | 题目id() |
content | 题目内容,限长80字,不可为空 填空题 格式{“before”:”1’,”after”:”2”} 翻译为before__after) |
explaininfo | 解析,限长500字 |
answers | 答案(单选多选最少两个答案,最多八个答案,填空一个答案) 问题的答案以及是否正确,不可为空,(该字段数据类型为 jsonArray,最 少2个最多8个选项,从上到下对应A-H),不可为空 |
字段answers中各字段含义如下
参数 | 说明 |
---|---|
content | 答案内容,单选多选限长50字,填空限长20字,不可为空 |
isright | 是否正确(否 0,是1,填空题默认为1),不可为空 |
注:
题目类型不可编辑
questions中questionid有值代表更新,无值代表新增,课堂练习下的问题不在questions列表中将被删除
3、一个时间点只能有一个练习
4、课堂练习中至少存在一个题目
5、一个视频最多20个课堂练习
返回信息如下
{ “result”:”OK”}
4.课堂练习删除
通过该接口可以删除课堂练习数据, 地址为:
https://spark.bokecc.com/api/exercise/delete
需要传递以下参数:
参数 | 说明 |
---|---|
userid | ⽤户 id,不可为空 |
videoid | 视频 id,不可为空 |
exerciseids | 练习id,操作多个练习以英文 , 分割,不可为空 |
返回信息如下
{ “result”:”OK”}
5.课堂题目列表查询
通过该接口可以为查询课堂练习的题目信息, 地址为:
https://spark.bokecc.com/api/exercise/question/list
需要传递以下参数:
参数 | 说明 |
---|---|
userid | ⽤户 id,不可为空 |
videoid | 视频 id,不可为空 |
exerciseid | 练习id,不可为空 |
返回字段字段含义如下
参数 | 说明 |
---|---|
id | 题目id |
type | 题目类型(0单选, 1多选, 2填空) |
content | 题目 |
totalnum | 答题次数 |
rightnum | 答对次数 |
explaininfo | 题目解析 |
返回信息如下
{
"result": "OK",
"questions": [
{
"id": "CF470410D36DE9EE",
"type": 0,
"content": "单选",
"explaininfo": "题目一注释",
"totalnum": 0,
"rightnum": 0
},
{
"id": "D0EA89550DEE23E4",
"type": 1,
"content": "单选",
"explaininfo": "题目二注释",
"totalnum": 0,
"rightnum": 0
}
]
}
6.课堂练习题目详情查询
通过该接口可以为查询课堂练习单个题目的数据, 地址为:
https://spark.bokecc.com/api/exercise/question/get
需要传递以下参数:
参数 | 说明 |
---|---|
userid | ⽤户 id,不可为空 |
videoid | 视频 id,不可为空 |
exerciseid | 练习id,不可为空 |
questionid | 题目id,不可为空 |
返回信息如下
参数 | 说明 |
---|---|
id | 题目id |
type | 题目类型(0单选, 1多选, 2填空) |
content | 题目内容 |
answers | 答案 |
totalnum | 答题次数 |
rightnum | 答对次数 |
explaininfo | 题目解析 |
返回字段answers
参数 | 说明 |
---|---|
id | 答案id |
content | 答案 |
isright | 是否正确(否 0,是1) |
返回信息如下
{
"result": "OK",
"question": {
"id": "CF470410D36DE9EE",
"type": 0,
"content": "问题1",
"explaininfo": "问题1注释",
"totalnum": 0,
"rightnum": 0,
"answers": [
{
"id": "1A4BAD48FFBD34F2",
"content": "A、选项一",
"isright": 0
},
{
"id": "55286BB5EC45452A",
"content": "B、选项二",
"isright": 0
},
{
"id": "DBD7F06C96C6368E",
"content": "C、选项三",
"isright": 1
},
{
"id": "EB680A6F8711521D",
"content": "D、选项四",
"isright": 0
}
]
}
}
7.课堂练习题目编辑
通过该接口可以为编辑课堂练习单个题目数据, 地址为:
https://spark.bokecc.com/api/exercise/question/update
需要传递以下参数:注 题目类型不可更改
参数 | 说明 |
---|---|
userid | ⽤户 id,不可为空 |
videoid | 视频 id,不可为空 |
exerciseid | 练习id,不可为空 |
questionid | 题目id,不可为空 |
content | 题目内容,限长80字,不可为空 填空题 格式{“before”:”1’,”after”:”2”} 翻译为before__after) |
explaininfo | 题目解析,限长500字 |
answers | 答案(单选多选最少两个答案,最多八个答案,填空一个答案,) 问题的答案以及是否正确,不可为空,(该字段数据类型为 jsonArray,最 少2个最多8个选项,从上到下对应A-H,示例( [ {"content":"选项一","isright":0},{"content":"选项二","isright":0} ] ) |
字段answers
参数 | 说明 |
---|---|
content | 答案内容,单选多选限长50字,填空限长20字,不可为空 |
isright | 是否正确(否 0,是1,填空题默认为1),不可为空 |
返回信息如下
{ “result”:”OK” }
8.课堂练习题目删除
通过该接口可以删除课堂练习单个题目数据, 地址为:
https://spark.bokecc.com/api/exercise/question/delete
需要传递以下参数:
参数 | 说明 |
---|---|
userid | ⽤户 id,不可为空 |
videoid | 视频 id,不可为空 |
exerciseid | 练习id,不可为空 |
questionids | 题目id,多个题目以英文 , 分割,不可为空 |
注:课堂练习至少保留一道题目
返回信息如下
{ “result”:”OK” }
9.课堂练习详情查询
通过该接口可以为查询课堂单个练习的数据, 地址为:
https://spark.bokecc.com/api/exercise/get
需要传递以下参数:
参数 | 说明 |
---|---|
userid | ⽤户 id,不可为空 |
videoid | 视频 id,不可为空 |
返回exercises各字段如下
参数 | 说明 |
---|---|
id | 练习id |
title | 练习名称 |
appeartime | 练习出现的时间 |
questions |
返回questions各字段如下
参数 | 说明 |
---|---|
id | 题目id |
type | 题目类型(0单选, 1多选, 2填空) |
content | 题目内容 |
answers | |
totalnum | 答题次数 |
rightnum | 答对次数 |
explaininfo | 题目解析 |
返回answers各字段如下
参数 | 说明 |
---|---|
id | 答案id |
content | 答案 |
isright | 是否正确(否 0,是1) |
返回信息如下
{
"result": "OK",
"exercises": [
{
"id": "F3CEA9F3FF0D306F",
"title": "课堂练习1",
"appeartime": 11,
"questions": [
{
"id": "CF470410D36DE9EE",
"type": 0,
"content": "单选",
"explaininfo": "题目解析",
"totalnum": 0,
"rightnum": 0,
"answers": [
{
"id": "A5111787F6CBE792",
"content": "A、选项一",
"isright": 0
},
{
"id": "B292E5F26254AF55",
"content": "B、选项二",
"isright": 0
},
{
"id": "8BA69B7A5CC92026",
"content": "C、选项三",
"isright": 1
},
{
"id": "11CDD78B4F830B15",
"content": "D、选项四",
"isright": 0
}
]
}
······
]
}
]
}