课堂练习

优质

小牛编辑

129浏览

2023-12-01

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保持一致

  [
  {
  "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
                        }
                    ]
                }
······
            ]
        }
    ]
}