[关闭]
@sewise-dev 2017-08-14T07:30:29.000000Z 字数 1983 阅读 543

智能组课接口文档

标签

api


更新历史

编号 版本 说明 作者 日期
1 v1.0 1.创建文档 GuQiuSheng 2017-06-19

目录


【备注】


1. 获取智能组课知识点列表

接口功能

获取智能组课知识点列表

说明
接口地址

/api/recommend/klglist

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数
参数 必选 类型 说明
Request Body
uid String 老师ID
to_uid Array 学生ID列表
course_id String 课程ID
time JSON JSON格式的获取样本数据时间段,详细信息请见 Time Item
count int 获取推荐知识点数量
type Array 组课规则,1代表知识点掌握度,2代表知识点答错率

Time Item

参数 必选 类型 说明
start String 开始时间,格式为2017-06-12 10:00:00
end String 开始时间,格式为2017-06-12 10:00:00
HTTP 响应状态

200

返回字段 字段类型 说明
data Array json格式的知识点列表结果,详细参数请见 Response Item

Response Item
知识点结构数据

其他响应状态描述请参照:【备注】-【错误码】

接口示例

Request

Response

2 获取学生推送课时知识点列表

接口功能

根据自定义app自定义规则,获取推荐课时

接口地址

/api/recommend/cklglist

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数
参数 必选 类型 说明
Request Body
uid String 老师ID
to_uid Array 学生ID
course_id String 课程ID
time JSON JSON格式的获取样本数据时间段,详细信息请见 Time Item
type Arrray 组课规则,1代表知识点掌握度,2代表知识点答错率

Time Item

参数 必选 类型 说明
start String 开始时间,格式为2017-06-12 10:00:00
end String 开始时间,格式为2017-06-12 10:00:00
HTTP 响应状态

200

返回字段 字段类型 说明
data Array json格式的列表结果,详细参数请见 Response Item

Response Item

返回字段 字段类型 说明
to_uid String 学生ID
data Array json格式的知识点列表结果

其他响应状态描述请参照:【备注】-【错误码】

接口示例

Request

Response

以下接口无效

3 获取指定学生学习知识点排行

接口功能

根据自定义条件,获取排序后的学生知识点列表

接口地址

/api/recommend/student/ranking

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数
参数 必选 类型 说明
Request Body
uid Array 学生ID列表
time JSON JSON格式的获取样本数据时间段,详细信息请见 Time Item
type Integer 组课规则,1代表知识点掌握度,2代表知识点答错率
count Integer 指定列表数量

Time Item

参数 必选 类型 说明
start String 开始时间,格式为2017-06-12 10:00:00
end String 开始时间,格式为2017-06-12 10:00:00
HTTP 响应状态

200

返回字段 字段类型 说明
data Array json格式的知识点列表结果,详细参数请见 Response Item

Response Item
课时包含的知识点结构数据

其他响应状态描述请参照:【备注】-【错误码】

接口示例

Request

Response

4 获取学生id

接口功能

获取学生ID,通过查询share表,获取学生样本数据

接口地址

/api/recommend/student

HTTP Content-Type

application/json

HTTP 请求方式

GET

请求参数

HTTP 响应状态

200

返回字段 字段类型 说明
data Array 学生ID列表

其他响应状态描述请参照:【备注】-【错误码】

接口示例

Request

Response

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注