web端对接方案文档

平台对接 知识元

UI flow 对照图

ui图上所标注的红⾊色标注对应接⼝口⽂文档标号。

129 知识元组件组课

1.知识元件课

地址： http://v.sewise.com/weike/MakeWeike?access_token=XXX&courseid=XXX&swlplay=true&iframe=1

2.保存课时

地址：http://v.sewise.com/weike/MakeWeike?courseid=XXX&swlplay=true&iframe=1#/sharemwei

133 微课在线制作

1.视频剪辑

地址：http://v.sewise.com/weike/make?access_token=XXX&iframe=1#/cut

2.选择课件

地址：http://v.sewise.com/weike/make?access_token=XXX&iframe=1#/choose

3.知识点与字幕

地址：http://v.sewise.com/weike/make?access_token=XXX&iframe=1#/zimu

1.用户中心

1.1 获取单用户授权access_tokne（单用户）

接口地址

/v1/user/getToken

HTTP Content-Type / 请求方式

application/json
get

请求参数

参数	必选	类型	说明
RequestBody
appid	是	String	第三方平台唯一凭证
secret	是	String	第三方平台唯一凭证密钥，即appsecret
uid	是	string	第三方平台的用户uid
type	否	int	用户类型： 1. 学生 2.老师(默认)
otherSchoolId	否	int	来源方平台的原学校/机构ID
otherClassId	否	int	来源方平台的原班级ID

HTTP 响应状态

200

接口示例

Request
curl -X get -H "Content-Type:application/json" -d http://v.sewise.com/v1/user/getToken?appid={APPID}&secret={SECRET}&uid={UID}

HTTP 响应状态

200

返回示例
{"status":200,"data":{"access_token":"qO9Bj6pqk0Ma7jh9hcBBOH1QcBb6467XC8YwJTcW","expire":"2018-06-15 11:45:36"}}

1.2 跳转web端

接口地址

/weike?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
get

请求参数

参数	必选	类型	说明
RequestBody
access_token	是	string	用户鉴权签证

HTTP 响应状态

200

接口示例

Request
curl -X get -H "Content-Type:application/json" -d http://v.sewise.com/weike?access_token=QVlBvVaijyRW2cRDVyF823zQoD8nXAV5QnBaK75O

2.录课

2.1 课程列表

接口地址

/course/all

HTTP Content-Type / 请求方式

application/json
GET

请求参数

RequestBody

参数	必选	类型	说明
RequestBody
access_token	是	string	用户鉴权签证
size	否	int	页码
page	否	int	页数
title	否	string	搜索标题

HTTP 响应状态

200

接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://v.sewise.com/course/all?access_token=xxxxxx

2.2 该课程所有课时列表

接口地址

/course/allChapter

HTTP Content-Type / 请求方式

application/json
GET

请求参数

RequestBody

参数	必选	类型	说明
RequestBody
access_token	是	string	用户鉴权签证
courseid	是	string	课程id

HTTP 响应状态

200

接口示例

Request
curl -X GET -H "Content-Type:application/json" -d http://v.sewise.com/course/allChapter?courseid=xxxxx&access_token=xxxxxx
Response
{"success":true,"data":[{"swlid":"95d78585-3314-4ad7-b44d-000bf133faec","creator_uid":"admin","creator_nickname":"管理员","title":"简介简介","duration":599.099,"image":"/video/photo/?path=storage/swlsource/video/39/f4c03753.mp4","is_open_topic":1,"video_url":"","poster":"","summary":"","require":"","create_time":"2017-02-08 16:39:54","knowledge":[{"klgid":"d5484376-85e4-4ed7-9434-b1ee92dd1fc1","title":"2","element_title":"","duration":23,"start_time":0,"end_time":23,"creator_uid":"admin","creator_nickname":"管理员","swpid":"918d03cf-3284-4da1-84ae-651529906173","swptitle":"","video_url":"storage/swlsource/video/39/f4c03753.mp4","video_name":"98888.mp4","assist_id":"","assist_url":"storage/swlsource/pdf/5b/3686c2f8.pdf","assist_name":"3686c2f8.pdf","create_time":"2017-02-08 16:39:09","image":"storage/swlsource/pdf/5b/3686c2f8/1.png","hide":"","quote_count":"","topic_ids":"","knowledge_element":[{"elgid":"6d7ab477-a543-4f6b-a179-76918bead5cc","title":"2","creator_uid":"admin","creator_nickname":"管理员","pdf_url":"","pdf_json":{"id":0,"page":1,"sTime":0,"title":"2","type":"1","eTime":23,"duration":23},"vtt_json":[],"topic_json":[],"timeline_json":"","event_timeline_json":"","duration":23,"start_time":0,"end_time":23,"create_time":"2017-02-08 16:39:09"],"_id":148}],"question_total":0,"klg_total":9,"_id":11}]}]}

2.3 知识点列表

接口地址

/knowledge/all

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
RequestBody
page	否	string	页数，默认为1
size	否	string	一页显示数量，默认为15
stime	否	string	创建开始时间，默认为空
etime	否	string	创建结束时间，默认为空
title	否	string	题目，默认为空
teacher	否	string	创建者id，默认为空
access_token	是	string	用户鉴权签证

HTTP 响应状态

200

接口示例

Request
curl -X get -H "Content-Type:application/json" -d
http://v.sewise.com/knowledge/all?access_token=xxxx
Response
{"success":true,"data":[{"klgid":"b6c2d703-4046-478a-a9da-330e7f6af144","title":"","element_title":"","duration":101,"start_time":172,"end_time":273,"creator_uid":"admin","creator_nickname":"管理员","swpid":"918d03cf-3284-4da1-84ae-651529906173","swptitle":"","video_url":"storage/swlsource/video/39/f4c03753.mp4","video_name":"98888.mp4","assist_id":"","assist_url":"storage/swlsource/pdf/5b/3686c2f8.pdf","assist_name":"3686c2f8.pdf","create_time":"2017-02-08 16:39:09","image":"storage/swlsource/pdf/5b/3686c2f8/4.png","hide":"","quote_count":"","topic_ids":"","knowledge_element":[{"elgid":"1a634112-915f-406d-ba9e-2d6243888e96","title":"","creator_uid":"admin","creator_nickname":"管理员","pdf_url":"","pdf_json":{"page":4,"sTime":172,"eTime":273,"id":3,"type":"1","title":"","duration":101},"vtt_json":[],"topic_json":[],"timeline_json":"","event_timeline_json":"","duration":101,"start_time":172,"end_time":273,"create_time":"2017-02-08 16:39:09"}]}],"pages":1}

2.4 课时列表

接口地址

/swl/all

HTTP Content-Type

application/json

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
title	否	string	课程标题，用于搜索
page	是	string	分页数
size	是	int	每页显示数目
stime	否	int	开始时间，用于搜索
etime	否	int	结束时间，用于搜索
grade	否	int	年级，用于搜索
subject	否	int	学科，用于搜索
courseid	否	int	课程id，用于搜索

HTTP 响应状态

200

data

2.5 提交课时

接口地址

/swl

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
swlid	否	string	课时id；修改时必传
courseid	是	string	课程id
image	是	string	截图
poster	是	string	封面
summary	是	string	简介
grade	是	string	年级（大学时为科目）
subject	是	string	学科（大学时为科目下专业）
coursetype	是	string	课程类型（预习课
subject_category	否	string	大学时学科
title	是	string	标题
is_open_topic	是	int	开启问答
is_open	否	int	是否发布
klg_total	是	int	知识点总数
question_total	int	是	问题总数
duration	是	int	视频时长
video_url	是	string	视频地址
kplist	是	array	知识点数组

HTTP 响应状态

200

2.6 删除课时

接口地址

/course/:swlid

HTTP 请求方式

DELETE

HTTP 响应状态

200

2.7 获取单个课程信息

接口地址

/swl/:swlid

HTTP 请求方式

GET

HTTP 响应状态

200

3.播放

3.1 微课信息

接口地址

/swl/{swlid}?access_token={access_token}

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
RequestPath
swlid	是	string	知识点课id
access_token	是	string	用户鉴权签证

HTTP 响应状态

200

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://v.sewise.com/swl/{swlid}?access_token={access_token}
Response
{"success":true,"data":{"page":3,"sTime":3,"id":2,"title":"阿萨德群","duration":2,"swpid":"pakit_8","_id":7609,"swpinfo":{"id":8,"name":"pa221.mp4","fullname":"storage/public/lubocam/pakit/pa221.mp4","type":"video","size":34657748,"time":1482990012,"phototime":134,"encrypt":0,"zip":1,"start_time":"0000-00-00 00:00:00","end_time":null,"duration":134,"camname":null,"sf1":null,"sf2":null,"sf3":null,"userid":"pakit","nickname":"pakit","swpid":"pakit_8","introduction":"","questionsnum":1,"knowlegenum":3,"_id":63}},{"page":2,"sTime":2,"id":1,"duration":2,"swpid":"pakit_10","_id":7668,"swpinfo":{"id":10,"name":"pa23.mp4","fullname":"storage/public/lubocam/pakit/pa23.mp4","type":"video","size":34657680,"time":1482990066,"phototime":134,"encrypt":0,"zip":1,"start_time":"0000-00-00 00:00:00","end_time":null,"duration":134,"camname":null,"sf1":null,"sf2":null,"sf3":null,"userid":"pakit","nickname":"pakit","swpid":"pakit_10","introduction":"","questionsnum":2,"knowlegenum":2,"_id":64}}}

3.2 播放器播放地址

接口地址

/swl/m3u8

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
RequestPath
swlid	是	string	知识点课id
access_token	是	string	用户鉴权签证

HTTP 响应状态

200

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://v.sewise.com/swl/m3u8
Response
{"success":true,"path":"http://sp05av100033108a.nrp.sewise.com.cn/storage/swlsource/m3u8/preview/1499674999620_29DA.m3u8"}

3.3 发布云空间

接口地址

/course/toCloud

HTTP Content-Type / 请求方式

application/json
post

请求参数

参数	必选	类型	说明
RequestPath
courseArr	是	数组	课程id的集合
access_token	是	string	用户鉴权签证

HTTP 响应状态

200
Response
{"success":true,"msg":""}

3.4 删除云空间课程

接口地址

/course/cloudDelete/:courseid

HTTP Content-Type / 请求方式

application/json
delete

请求参数

参数	必选	类型	说明
RequestPath
courseid	是	string	课程的id，多个用逗号隔开
access_token	是	string	用户鉴权签证

HTTP 响应状态

200
Response
{"success":true,"msg":""}

4.学生端

4.1 获取教师列表

接口地址

/swl/share/fromList

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
RequestBody
access_token	是	string	用户鉴权签证

HTTP 响应状态

200

data信息解析

请求接口用的都是username，nickname没有用到，nickname只是用来前端展示，一般是中文

接口示例

Request
curl -X GET -H "Content-Type:application/json" -d {"access_token"："xxxxxx"} http://v.sewise.com/swl/share/fromList?access_token=xxxx
Response
{"success":true,"data":[{"username":"admin","nickname":"管理员"},{"username":"pakit","nickname":"pakit"},{"username":"teacher2","nickname":"老师2号"},{"username":"kakaxi","nickname":"卡卡西"},{"username":"50","nickname":"吴老师"},{"username":"60","nickname":"严老师"},{"username":"70","nickname":"赵老师"},{"username":"yuwenlaoshi","nickname":"语文老师"}]}

4.2 我的微课

接口地址

/swl/all

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
RequestBody
page	否	string	页数，默认为1
size	否	string	一页显示数量，默认为15
stime	否	string	创建开始时间，默认为空
etime	否	string	创建结束时间，默认为空
title	否	string	题目，默认为空
teacher	否	string	创建者id，默认为空
access_token	是	string	用户鉴权签证

HTTP 响应状态

200

接口示例

Request
curl -X GET -H "Content-Type:application/json" -d {"access_token"："xxxxx"，"q":"k"} http://v.sewise.com/swl/all?{access_token}
Response
{"success":true,"data":[{"swlid":"95d78585-3314-4ad7-b44d-000bf133faec","creator_uid":"admin","creator_nickname":"管理员","title":"简介简介","duration":599.099,"image":"/video/photo/?path=storage/swlsource/video/39/f4c03753.mp4","is_open_topic":1,"video_url":"","poster":"","summary":"","require":"","create_time":"2017-02-08 16:39:54","knowledge":[{"klgid":"d5484376-85e4-4ed7-9434-b1ee92dd1fc1","title":"2","element_title":"","duration":23,"start_time":0,"end_time":23,"creator_uid":"admin","creator_nickname":"管理员","swpid":"918d03cf-3284-4da1-84ae-651529906173","swptitle":"","video_url":"storage/swlsource/video/39/f4c03753.mp4","video_name":"98888.mp4","assist_id":"","assist_url":"storage/swlsource/pdf/5b/3686c2f8.pdf","assist_name":"3686c2f8.pdf","create_time":"2017-02-08 16:39:09","image":"storage/swlsource/pdf/5b/3686c2f8/1.png","hide":"","quote_count":"","topic_ids":"","knowledge_element":[{"elgid":"6d7ab477-a543-4f6b-a179-76918bead5cc","title":"2","creator_uid":"admin","creator_nickname":"管理员","pdf_url":"","pdf_json":{"id":0,"page":1,"sTime":0,"title":"2","type":"1","eTime":23,"duration":23},"vtt_json":[],"topic_json":[],"timeline_json":"","event_timeline_json":"","duration":23,"start_time":0,"end_time":23,"create_time":"2017-02-08 16:39:09"],"_id":148}],"question_total":0,"klg_total":9,"_id":11}]}],"pages":1}

4.3 知识点

接口地址

/knowledge/all

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
RequestBody
page	否	string	页数，默认为1
size	否	string	一页显示数量，默认为15
stime	否	string	创建开始时间，默认为空
etime	否	string	创建结束时间，默认为空
title	否	string	题目，默认为空
teacher	否	string	创建者id，默认为空
access_token	是	string	用户鉴权签证

HTTP 响应状态

200

接口示例

Request
curl -X GET -H "Content-Type:application/json" -d {"access_token"："xxxx"，"q":"zhisdhain"} http://v.sewise.com/knowledge/all?access_token={access_token}
Response
{"success":true,"data":[{"klgid":"b6c2d703-4046-478a-a9da-330e7f6af144","title":"","element_title":"","duration":101,"start_time":172,"end_time":273,"creator_uid":"admin","creator_nickname":"管理员","swpid":"918d03cf-3284-4da1-84ae-651529906173","swptitle":"","video_url":"storage/swlsource/video/39/f4c03753.mp4","video_name":"98888.mp4","assist_id":"","assist_url":"storage/swlsource/pdf/5b/3686c2f8.pdf","assist_name":"3686c2f8.pdf","create_time":"2017-02-08 16:39:09","image":"storage/swlsource/pdf/5b/3686c2f8/4.png","hide":"","quote_count":"","topic_ids":"","knowledge_element":[{"elgid":"1a634112-915f-406d-ba9e-2d6243888e96","title":"","creator_uid":"admin","creator_nickname":"管理员","pdf_url":"","pdf_json":{"page":4,"sTime":172,"eTime":273,"id":3,"type":"1","title":"","duration":101},"vtt_json":[],"topic_json":[],"timeline_json":"","event_timeline_json":"","duration":101,"start_time":172,"end_time":273,"create_time":"2017-02-08 16:39:09"}]}],"pages":1}

4.4 我的错题

接口地址

/statistics/student/wrong

HTTP Content-Type / 请求方式

application/json
get

请求参数

参数	必选	类型	说明
RequestBody
access_token	是	string	用户鉴权签证
swlid	否	string	课件id
teacher_id	否	string	老师id，用于需要根据老师id查询时
time	否	string	时间id，用于需要根据老师id查询时

HTTP 响应状态

200

data信息解析

接口示例

Request
curl -X get -H "Content-Type:application/json" -d {"access_token"："xxx"，"q":"问题"} http://v.sewise.com/statistics/student/wrong?{access_token}
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"}]}

4.5 我的错题关联知识点功能

4.5.1 我的错题关联的知识点(单个微课)

接口地址

/statistics/student/wrongkonwledge

HTTP Content-Type / 请求方式

application/json
get

请求参数

参数	必选	类型	说明
access_token	是	string	用户鉴权签证
swlid	是	string	课程id
klgid	是	string	问题关联的知识点id

HTTP 响应状态

200

result

接口示例

Request
curl -X get -H "Content-Type:application/json" http://v.sewise.com/statistics/student/wrongkonwledge/:swlid/:klgid
Response
{"result":[{"klgid":"58059f12-e8a1-4f9e-94fe-7d99714e683d","title":"默认标题","element_title":"","duration":8,"start_time":0,"end_time":8,"creator_uid":"lilaoshi020701","creator_nickname":"李老师020701-修改信息","swpid":"85db4bd5-30f1-4070-9409-4279bf88c648","swptitle":"","video_url":"storage/swlsource/video/19/b42fb269.mp4","video_name":"黄老师课程-三合一.mp4","assist_id":"","assist_url":"storage/swlsource/pdf/26/3e9c1005.pdf","assist_name":"3e9c1005.pdf","create_time":"2035-12-23 05:41:11","image":"storage/swlsource/pdf/26/3e9c1005/1.png","hide":"","quote_count":"","topic_ids":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","knowledge_element":[{"elgid":"9c348f41-a791-4497-bcb6-813b32b46e36","title":"默认标题","creator_uid":"lilaoshi020701","creator_nickname":"李老师020701-修改信息","pdf_url":"","pdf_json":{"id":0,"page":1,"sTime":0,"title":"默认标题","type":"1","eTime":8,"duration":8},"vtt_json":[{"sTime":4,"eTime":6,"content":"范德萨范德萨发大厦的地方"}],"topic_json":[{"creator_uid":"admin","type":"multiple","question":"黄老师课程-三合一的问答，PPT01","option":["D","D","C","D"],"answer":[{"content":"D","rightAnswer":"true"},{"content":"D","rightAnswer":"true"},{"content":"C","rightAnswer":"false"},{"content":"D","rightAnswer":"true"}],"create_time":"2035-12-23 04:54:07","topic_id":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","_id":136,"id":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","uuid":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","question_id":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","showTime":8,"pdfDataID":1,"page":2,"rightJumpTime":8,"errorJumpTime":0,"answerindex":[0,1,3]}],"timeline_json":"","event_timeline_json":"","duration":8,"start_time":0,"end_time":8,"create_time":"2035-12-23 05:41:11","klgid":"58059f12-e8a1-4f9e-94fe-7d99714e683d","swpid":"85db4bd5-30f1-4070-9409-4279bf88c648"}],"_id":2289}],"swltitle":"制作微课删除了知识点"}

4.5.2 我的错题关联的知识点(全部微课)

接口地址

/statistics/student/allwrongkonwledge

HTTP Content-Type / 请求方式

application/json
get

请求参数

参数	必选	类型	说明
access_token	是	string	用户鉴权签证
swlid	是	string	课程id
topic_id	是	string	问题id

HTTP 响应状态

200

result

接口示例

Request
curl -X get -H "Content-Type:application/json" http://v.sewise.com/statistics/student/allwrongkonwledge/:swlid/:topic_id
Response
{"result":[{"klgid":"58059f12-e8a1-4f9e-94fe-7d99714e683d","title":"默认标题","element_title":"","duration":8,"start_time":0,"end_time":8,"creator_uid":"lilaoshi020701","creator_nickname":"李老师020701-修改信息","swpid":"85db4bd5-30f1-4070-9409-4279bf88c648","swptitle":"","video_url":"storage/swlsource/video/19/b42fb269.mp4","video_name":"黄老师课程-三合一.mp4","assist_id":"","assist_url":"storage/swlsource/pdf/26/3e9c1005.pdf","assist_name":"3e9c1005.pdf","create_time":"2035-12-23 05:41:11","image":"storage/swlsource/pdf/26/3e9c1005/1.png","hide":"","quote_count":"","topic_ids":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","knowledge_element":[{"elgid":"9c348f41-a791-4497-bcb6-813b32b46e36","title":"默认标题","creator_uid":"lilaoshi020701","creator_nickname":"李老师020701-修改信息","pdf_url":"","pdf_json":{"id":0,"page":1,"sTime":0,"title":"默认标题","type":"1","eTime":8,"duration":8},"vtt_json":[{"sTime":4,"eTime":6,"content":"范德萨范德萨发大厦的地方"}],"topic_json":[{"creator_uid":"admin","type":"multiple","question":"黄老师课程-三合一的问答，PPT01","option":["D","D","C","D"],"answer":[{"content":"D","rightAnswer":"true"},{"content":"D","rightAnswer":"true"},{"content":"C","rightAnswer":"false"},{"content":"D","rightAnswer":"true"}],"create_time":"2035-12-23 04:54:07","topic_id":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","_id":136,"id":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","uuid":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","question_id":"dfb3cd97-5477-4182-b6d3-cdf064e29b3d","showTime":8,"pdfDataID":1,"page":2,"rightJumpTime":8,"errorJumpTime":0,"answerindex":[0,1,3]}],"timeline_json":"","event_timeline_json":"","duration":8,"start_time":0,"end_time":8,"create_time":"2035-12-23 05:41:11","klgid":"58059f12-e8a1-4f9e-94fe-7d99714e683d","swpid":"85db4bd5-30f1-4070-9409-4279bf88c648"}],"_id":2289}],"swltitle":"制作微课删除了知识点"}

4.6 通过swlid获取课程

接口地址

/swl

HTTP Content-Type / 请求方式

application/json
GET

请求参数

参数	必选	类型	说明
RequestPath
access_token	是	string	用户鉴权签证
swlid	是	string	课程id

HTTP 响应状态

200

接口示例

Request
curl -X GET -H "Content-Type:application/json" http://v.sewise.com/swl/swlid?access_token={access_token}
Response
{"success":true,"data":{"page":3,"sTime":3,"id":2,"title":"阿萨德群","duration":2,"swpid":"pakit_8","_id":7609,"swpinfo":{"id":8,"name":"pa221.mp4","fullname":"storage/public/lubocam/pakit/pa221.mp4","type":"video","size":34657748,"time":1482990012,"phototime":134,"encrypt":0,"zip":1,"start_time":"0000-00-00 00:00:00","end_time":null,"duration":134,"camname":null,"sf1":null,"sf2":null,"sf3":null,"userid":"pakit","nickname":"pakit","swpid":"pakit_8","introduction":"","questionsnum":1,"knowlegenum":3,"_id":63}},{"page":2,"sTime":2,"id":1,"duration":2,"swpid":"pakit_10","_id":7668,"swpinfo":{"id":10,"name":"pa23.mp4","fullname":"storage/public/lubocam/pakit/pa23.mp4","type":"video","size":34657680,"time":1482990066,"phototime":134,"encrypt":0,"zip":1,"start_time":"0000-00-00 00:00:00","end_time":null,"duration":134,"camname":null,"sf1":null,"sf2":null,"sf3":null,"userid":"pakit","nickname":"pakit","swpid":"pakit_10","introduction":"","questionsnum":2,"knowlegenum":2,"_id":64}}}

4.7 撕书功能

4.7.1 保存撕书记录

接口地址

/wipe/add

HTTP Content-Type / 请求方式

application/json
POST

请求参数

参数	必选	类型	说明
RequestBody
access_token	是	string	用户鉴权签证
wipe_id	否	string	唯一识别码uuid，撕书id
create_time	否	string	创建时间
swlid	是	string	课件id
klgid	是	string	知识点id

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d {"swlid"："123321"，klgid:"123321"}
url: http://api.sewise.com/wipe/add
Response
成功:{"result":success}
失败:{"result":failure}

4.7.2 删除撕书记录

接口地址

/wipe/

HTTP Content-Type / 请求方式

application/json
DELETE

请求参数

参数	必选	类型	说明
RequestBody
access_token	是	string	用户鉴权签证
wipe_id	否	string	唯一识别码uuid，撕书id
create_time	否	string	创建时间
swlid	是	string	课件id
klgid	是	string	知识点id

HTTP 响应状态

200

接口示例

Request
curl -X DELETE -H "Content-Type:application/json" -d {"swlid"："123321"，klgid:"123321"}
url: http://v.sewise.com/wipe/delete
Response
{"success":true}

5.外部播放器API

注意：一个页面只能引用一个播放器，生成新的播放器，应先将原先的播放器容器销毁

5.1 播放器引用方式

通过嵌入html页面的方式渲染播放器

参数

参数	必选	类型	说明
host	是	string	微录播域名
swlid	是	string	微课swlid
uid	是	int	自主平台用户id
access_token	是	string	用户鉴权码access_token
type	是	int	用户类型，默认1为学生，2为老师
callback	否	boolean	是否需要主动发送播放进度
callbackUrl	否	string	主动发送的地址（当callback为true,此参数必须）
playProgress	否	int	设置播放进度（数值范围：1-100），设置此参，播放进度将会从此开始播放

拼写规则

1.生成设置参数

var obj ={
    'host' : 'http://v.sewise.com' ,
    'swlid' : '4593843e-05c1-460e-af30-831920a930ed' ,
    'uname' : 12 ,
    'callback' : true ,
    'callbackUrl' : 'http://v.sewise.com/addplay?userid=12' , //自主平台路径，此处userid是为不同用户保存不同进度
    'playProgress' : 50
}
var playerdata = encodeURI(JSON.stringify(obj));//将参数转成json字符串，再进行encodeURI转码
var playerhtml = '<script id="sewiseswlplayer" src="'+obj.host+'/widgets/libs/sewiseswlplayer.js?data='+playerdata+'" charset="utf-8"></script>';//播放地址

2.代码生成结果示例

<script id="sewiseswlplayer" src="http://v.sewise.com/widgets/libs/sewiseswlplayer.js?data=%7B%22host%22:%22http://v.sewise.com%22,%22swlid%22:%224593843e-05c1-460e-af30-831920a930ed%22,%22uname%22:12,%22callback%22:true,%22callbackUrl%22:%22http://v.sewise.com/addplay?userid=12%22,%22playProgress%22:50%7D"charset="utf-8"></script>

3.将代码放入html页面，即可生成sewise播放器

callbackUrl要求

播放器主动传递的参数

请求方式：post

参数	类型	说明
precent	int	百分比(数值范围：1-100)
total_time	int	视频总时长(s)
playTime	int	当前播放时间(s)

5.2 播放器控制接口

支持的接口

• pause 暂停
• play 播放
• stop 停止
• playTime 获取当前视频播放到的位置（秒）

接口使用方式

播放器引用成功后，将会生成一个全局的函数变量：window.getSWLPlayer

示例

//以鼠标移出播放器，播放自动暂停为例
window.getSWLPlayer(function (sw) {
    //sw为播放器对象
    $(sw.el).on('mouseleave',function(){//表示离开播放器组件
        sw.pause();//调用播放器暂停方法
    })
})