微录播统计接口文档（最新）

微录播

更新历史

目录

1.统计接口

1.1 课程共享

接口地址

/statistics/share

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
swlid	string	课程swlid

HTTP 响应状态

200

data

share

study

answer

point

list

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://statistics.luobo.com/statistics/list
Response
{"result":{"share":{"total":3,"finished":0,"studying":0,"notstart":0},"study":{"ave_spend_time":623080,"max_spend_time":890080,"mix_spend_time":89080},"point":{"point_grasp_rate":"0.53","grasp_num":0},"answer":{"correct_rate":"0.40","correct_num":0},"list":[{"uid":"5112","name":"张老师","process":"0.04","total_spendtime":890080,"finish_time":"149009209909"},{"uid":"5110","name":"张老师","process":"0.04","total_spendtime":890080,"finish_time":"149009209909"},{"uid":"5111","name":"张老师","process":"0.04","total_spendtime":89080,"finish_time":"149009209909"}]}}

1.2 用户学习详情

接口地址

/statistics/user/:swlid/:uid

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
swlid	string	微课swlid
uid	string	用户uid

HTTP 响应状态

200

data

study

answer

point

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://statistics.luobo.com/statistics/user
Response
{"result":{"study":{"precent":"0.04","spend_time":"3600"},"answer":{"precent":"0.40","total":"10","correct":"4","wrong":29},"point":{"precent":"0.60","total":"5","grasp":"3","disgrasp":2}}}

1.2.1 用户学习进度详情

接口地址

/statistics/:swlid/:uid

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
swlid	string	微课swlid
uid	string	用户uid

HTTP 响应状态

200

data

list（学习统计数据）

data（节点学习进度）

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://statistics.luobo.com/statistics/user/study
Response
{"result":{"share":["0%","10%","20%","30%","40%","50%","60%","70%","80%","90%","100%"],"list":[[{"id":"fc3ef100-dc95-11e6-b872-dd7574160f84","precent":"0.2","create_time":"1484644742173","round":1,"data":{"correct_precent":"0.40","point_precent":"0.60","study_time":60}},{"id":"347903d0-dc96-11e6-9ea6-f192bce90860","precent":"0.4","create_time":"1484644836497","round":1,"data":{"correct_precent":"0.40","point_precent":"0.60","study_time":"120"}},{"id":"74406080-dc96-11e6-b605-ef0a6ba51af0","precent":"0.4","create_time":"1484644943508","round":1,"data":{"correct_precent":"0.40","point_precent":"0.60","study_time":"180"}}]]}}

1.2.2 用户答对率详情

接口地址

/statistics/user/answer/:swlid/:uid

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
swlid	string	微课swlid
uid	string	用户uid

HTTP 响应状态

200

data

wrong_data

answers

wrong_list

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://statistics.luobo.com/statistics/user/answer
Response
{"list":{"wrong_data":[[{"question_id":"bc227250-db8b-11e6-b348-9d4ecc8d4129","title":"nodejs底层使用什么语言实现的?2","answers":["javascript","c","java","go"],"user_answer":"2","correct":"1"},{"question_id":"wq227250-db8b-11e6-b348-9d4ecc8d6129","title":"nodejs底层使用什么语言实现的?1","answers":["javascript","c","java","go"],"user_answer":"2","correct":"1"}],[]],"wrong_list":[{"id":"bc227250-db8b-11e6-b348-9d4ecc8d5129","title":"微录播是什么?"},{"id":"bc227250-db8b-11e6-b348-9d4ecc8d7129","title":"nodejs底层使用什么写的？"}]}}

1.2.3 知识掌握度

接口地址

/statistics/user/point/:swlid/:uid

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
swlid	string	微课swlid
uid	string	用户uid

HTTP 响应状态

200

data

grasp_data
first(首轮学习擦除)

more(多次学习后擦除)

disgrasp_list

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://statistics.luobo.com/statistics/user/point
Response
{
"status": 200,
"data": [{"grasp_data":[{"first":[{'id':1,"title":"微录播相机有几种配网方式?","time":'14009999'},{'id':2,"title":"微录播是视智云推出的一款微型录制与播出系统?","time":'14009999'}],"more":[{'id':1,"title":"微录播相机有几种配网方式?","time":'14009999'},{'id':2,"title":"微录播是视智云推出的一款微型录制与播出系统?","time":'14009999'}]}],"disgrasp_list":[{'id':1,'title':'微录播相机有几种配网方式?'},{'id':2,'title':'微录播是视智云推出的一款微型录制与播出系统?'}]}]
}

1.3 错题排行

接口地址

/statistics/wrongranking/:swlid

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
swlid	string	课程id

HTTP 响应状态

200

result

rate

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://statistics.luobo.com/statistics/wrongranking
Response
{
{"result":[{"topic_id":"bc227250-db8b-11e6-b348-9d4ecc8d4129","type":"single","question":"nodejs底层使用什么写的？","option":[0,3,3,0],"answer":"2","rate":{"rate":"1.00","wrong":6,"total":6}},{"topic_id":"wq227250-db8b-11e6-b348-9d4ecc8d6129","type":"single","question":"nodejs底层使用什么写的？","option":[0,0,1,0],"answer":"2","rate":{"rate":"1.00","wrong":1,"total":1}}]}
}

1.4 知识点统计

接口地址

/statistics/points/:swlid

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
swlid	string	微课id

HTTP 响应状态

200

data

wrong/clear

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://statistics.luobo.com/statistics/points
Response
{
"status": 200,
"data": [{"uuid":"4","title":"微录播相机配网方式","wrong":[{"count":10,'total':20}],"clear":[{"count":10,'total':20}]}]
}

1.5 (学生端)我已擦除

接口地址

/statistics/student/clear/:swlid/:uid

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
uid	string	用户id
swlid	string	课时id

HTTP 响应状态

200

data

summary

list

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://statistics.luobo.com/statistics/student/clear
Response
{"result":{"summary":{"count":3,"time":180},"list":[{"page":3,"sTime":67,"id":10,"title":"随时录制，快速同步2","duration":3,"clear":true,"swpid":"pakit_12"},{"page":4,"sTime":67,"id":10,"title":"随时录制，快速同步","duration":3,"clear":true,"swpid":"pakit_12"},{"page":2,"sTime":67,"id":10,"title":"随时录制，快速同步","duration":3,"clear":true,"swpid":"pakit_12"}]}}

1.6 (学生端)我的错题

接口地址

/statistics/student/wrong

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
creator_uid	string	用户id	必需
swlid	string	课程id	必需
teacher_id	string	老师id	用于需要根据老师id查询时
time	string	时间id	用于需要根据老师id查询时

HTTP 响应状态

200

data

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://statistics.luobo.com/statistics/student/wrong
Response
{"status":200,"data":[{"creator_uid":"5112","klgid":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97","swlid":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97","topic_id":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97","question":"nodejs底层使用什么语言实现的?","option":["javascript","c","java","go"],"answer":"2","right_answer":"1","is_right":"0","create_time":"2017-01-16 10:37:39"},{"creator_uid":"5112","klgid":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97","swlid":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97","topic_id":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97","question":"nodejs底层使用什么语言实现的?","option":["javascript","c","java","go"],"answer":"2","right_answer":"1","is_right":"0","create_time":"2017-01-16 10:37:42"},{"creator_uid":"5112","klgid":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97","swlid":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97","topic_id":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97","question":"nodejs底层使用什么语言实现的?","option":["javascript","c","java","go"],"answer":"2","right_answer":"1","is_right":"0","create_time":"2017-01-16 10:37:43"}]}

1.7 (学生端)我的错题关联的知识点(单个微课)

接口地址

/statistics/student/wrongkonwledge/:swlid/:klgid

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
swlid	string	课程id	必需
klgid	string	问题关联的知识点id	必需

HTTP 响应状态

200

result

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://statistics.luobo.com/statistics/student/wrongkonwledge
Response
{
"result":[{"title":"微录播是一个知识的海洋1","video_url":"http://localhost:3000/image/1.mp4","image":"http://localhost:3000/image/1.png","duration":"4500","swptitle":"微录播","creator_nickname":"张老师"}]
}

1.8 (学生端)我的错题关联的知识点(全部微课)

接口地址

/statistics/student/allwrongkonwledge/:swlid/:topic_id/:klgid

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
swlid	string	课程id	必需
topic_id	string	问题id	必需
klgid	string	知识点id	必需

HTTP 响应状态

200

data

result

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://statistics.luobo.com/statistics/student/allwrongkonwledge
Response
{"result":[{"title":"微录播是一个知识的海洋1","video_url":"http://localhost:3000/image/1.mp4","image":"http://localhost:3000/image/1.png","duration":"4500","swptitle":"微录播","creator_nickname":"张老师"},{"title":"微录播是一个知识的海洋1","video_url":"http://localhost:3000/image/1.mp4","image":"http://localhost:3000/image/1.png","duration":"4500","swptitle":"微录播","creator_nickname":"张老师"},{"title":"微录播是一个知识的海洋1","video_url":"http://localhost:3000/image/1.mp4","image":"http://localhost:3000/image/1.png","duration":"4500","swptitle":"微录播","creator_nickname":"张老师"}]}

2.统计数据录入

2.1 答题记录入库

接口地址

app.getService('statistics').student.addwrong

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
creator_uid	string	用户id	必需
teacher_id	string	老师id	必需
klgid	string	知识点id	必需
swlid	string	课件id	必需
answer	string	选项id	必需
topic_id	string	问题id	必需

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://statistics.luobo.com/statistics/wrong/add
Response
{
"id":"d9ef3300-da36-11e6-b8e6-29424bbccfef",
"uid":"5112",
"swpid":"e4f25901-d7e1-11e6-b8a7-b720db0f6d97",
"question_id":"3b77d840-d7d3-11e6-ad05-fbb27da67fa4",
"answer_id":"2",
"uuid":"",
"time":"2017-01-14 16:53:00",
"round":6,"question":
"nodejs底层使用什么语言实现的？2",
"option":["javascript","c","java","php"],
"right_id":"1",
"right":0,
"_id":"5879e6ec5694fc229cb2fc8e"
}

2.2 擦除记录入库

方法调用

app.getService('statistics').student.addclear

请求参数

参数	必选	类型	说明
uid	是	string	用户id
pdf_id｜是	string	pdf的id

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://statistics.luobo.com/statistics/clear/add
Response
{
"status": 200,
"mes": "xxxxx"
}

2.3 播放记录入库

方法调用

app.getService('statistics').student.addplay

请求参数

参数	必选	类型	说明
uid	是	string	用户id
swlid｜是	string	课件的id
time｜是	string	播放视频的当前真实时刻

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://statistics.luobo.com/statistics/clear/add
Response
{
"status": 200,
"mes": "xxxxx"
}

3. 提问

3.1 提问提交（学生）

接口地址

/ask

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
classHashId	是	string	课时hashid
classTitle	是	string	课时名称
klgHashId	是	string	知识点hashid
klgTitle	是	string	知识点名称
toId	是	string	接收者uid
content	是	string	内容

HTTP 响应状态

200

3.2 回复（老师）

接口地址

/ask

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
classHashId	是	string	课时hashid
classTitle	是	string	课时名称
klgHashId	是	string	知识点hashid
klgTitle	是	string	知识点名称
toId	是	string	接收者uid
content	是	string	内容
toAskId	是	string	回复的问题askid

HTTP 响应状态

200

3.3 提问列表（老师/学生）

接口地址

/ask/list

HTTP Content-Type

application/json

HTTP 请求方式

get

请求参数

参数	必选	类型	说明
RequestBody
title	否	string	搜索问题的关键字
fromId	否	string	发送者uid
toId	否	string	接收者uid
sTime	否	string	开始时间(按时间区间搜索)
eTime	否	string	结束时间(按时间区间搜索)
classHashId	否	string	课时hashid
klgHashId	否	string	知识点hashid

HTTP 响应状态

200

3.4 获取提问回复内容

接口地址

/ask/answer/:askId

HTTP Content-Type

application/json

HTTP 请求方式

get

请求参数

参数	必选	类型	说明
RequestBody

HTTP 响应状态

200

3.5 修改提问回复内容

接口地址

/ask/:askId

HTTP Content-Type

application/json

HTTP 请求方式

put

请求参数

参数	必选	类型	说明
RequestBody
content	是	string	内容

HTTP 响应状态

200

4.创建帐号上报

4.1 创建帐号上报

接口地址

/statistics/createAccount

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
userId	是	int	帐号id
username	是	string	帐号名
userType	是	int	用户类型
expertRank	是	int	专家类型
nickName	是	string	昵称
organId	是	int	组织id
organKind	是	int	组织类型
provinceName	是	string	省份
cityName	是	string	城市
areaName	是	string	地区
province	是	string	省代号
city	是	string	市代号
area	是	string	地区代号

userType:1

参数	必选	类型	说明
tid	否	string	老师id;所在班级/专业(大学)存在执教老师时;多个老师时用','隔开
tname	否	string	老师帐号;多个老师时用','隔开

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" http://statistics.luobo.com/ask/statistics/createAccount
Response
{"status":true,"mes":"xxx"}
{"status":false,"mes":"xxx"}