domain http://b.xuetangx.com/oplat/
服务端获取Authorization Code
url /user/authorize
method GET
query
{
"appid": {appid},
"appsecret": {appsecret},
"nonce": {nonce} //随机数
}response
{
"status": 0,
"code": {code}
}请求二维码
url /user/login
method GET
query
{
"code": {code} //上一步获取到的code
}response
{
"status": 0,
"message": "success",
"data": {
"loginid": 222, //本次登录的id，用于后续扫码成功后通知时相匹配
"expire_seconds": 60, //客户端本次请求二维码的过期时间，过期后需要重新请求
"ticket": "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQHk8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL216b0pHV1RseEZHOTZrdjYweFQzAAIEVoYJWAMEAI0nAA==", //二维码
图片
"url": "http://weixin.qq.com/q/mzoJGWTlxFG96kv60xT3" //二维码实际地址
}
}通知扫码成功
url {第三方注册的回调地址}
method POST
response
{
"action": "login",
"login_id": 222, //对应请求二维码时的登录id
"UserID": "int型用户id如123",
"Name": "用户名字",
"Nickname": "微信昵称",
"Avatar": "微信头像的url地址,http://wx.qlogo.cn/mmopen/tnGT4YBoSbbUZmECibSLnDu2z5r2bpbDtH7zAiadRETvU8bQlTR8ObiapVUlaejbOiafmOkM8my6Q5NZ3dC3ACHIxIGKL27fxYG0/0",
"WeixinUnionID": "微信的unionid,owHdquIH-AdQD7UMPohiIaQGjfA8",
"AppOpenID": "用户针对此公众号的appid默认为none,oM_HWwYUcgHV9ewbAt76kWSeoL3g",
"School": "所在院校",
"Department": "所在院系",
"Role": "身份,默认为0:0未填写1在校学生2老师3其他人员",
"Position": "职别信息，默认为空",
"YearOfBirth": "出生年份,datetime格式日期",
"Gender": "性别,默认为0:0未填写1男2女",
"LastLoginIP": "上次登录ip,如127.0.0.1",
"DateJoined": "帐号注册时间datetime时间,%Y-%m-%dT%H:%M:%S格式",
"LastLogin": "上次登录时间datetime时间,%Y-%m-%dT%H:%M:%S格式",
"Auth": "uuid的加密,str类型", //后续接口中的access_token
"Beta": {"DownloadURL": "http://b.xuetangx.com", "ChangeLog": "beta1.0.0.25\u7248", "Version": "1.0.0.25", "LaunchDate": "2016-03-31T16:15:41"},
"Stable": {"DownloadURL": "http://rain.xuetangx.com/", "ChangeLog": "\u6295\u7968\u6700\u591a\u53ef\u9009\u9879\u6570\u76ee\u4e0d\u4e00\u81f4\u4fee\u6539", "Version": "1.0.0.39", "LaunchDate": "2016-05-10T09:52:10"}
}时间校对
url /timestamp
method GET
query
{
}response
{
"status": 0,
"message": 'ok',
"data": {
"timestamp": 1402334034
}
}新建任务
url /task/create
method POST
body
{
"access_token": {access_token},
"name": "任务名称", //必填
"target": "任务目标", //必填
"category": "experiment", //任务类别：["experiment"]
"custom": [ //自定义项，可选
{
"field": "实验要求",
"content": "xxxxxxx"
}
],
"attachment": [ //附件，可选
{
"id": "xxxx",
"url": "http://xxxx"
"size": 12212,
"originalname": "filename"
}
]
}response
{
"status": 0,
"message": 'ok',
"data": {
"task_id": "582d79f909d8fd4cc56fe7c7" //实验id，str
}
}发布任务
url /task/publish
method POST
body
{
"access_token": {access_token},
"task_id": {task_id}, //必填
"class": [1,2,3,4,10], //班级id, 必需有id
"deadline": 1402334034 //截止时间戳(精确到秒)
}response
{
"status": 0,
"message": 'ok'
}删除任务
url /task/delete
method POST
body
{
"access_token": {access_token},
"task_id": {task_id} //必填
}response
{
"status": 0,
"message": 'ok'
}获取任务信息
url /task/info
method GET
query
{
"access_token": {access_token},
"task_id": {task_id} //必填
}response
{
"status": 0,
"message": 'ok',
"data": {
"task_id": {task_id},
"teacher_id": 1,
"name": "任务名称",
"target": "任务目标",
"created_time": 1510564211,
"custom": [{
"field": "任务要求",
"content": "xxxxx"
}],
"attachment": [
{ //附件，可选
"id": "b85b85472e74431b8508f7db4173a689",
"size": 5114,
"url": "http://ogs54adkk.bkt.clouddn.com/r/20171120/932506264435560448.xml",
"originalname": "Test.xml"
}
],
"publish": [
{
"class_id": 2470,
"publish_time": 1510564211, //发布时间戳(精确到秒)
"deadline": 1402341250, //截止时间戳(精确到秒)
"is_pushed": 0 //不用关注，其他地方用
},
{
"class_id": 2472,
"publish_time": 1510564211,
"deadline": 1402341250,
"is_pushed": 0
}
]
}
}上传任务行为数据
url /task/actions
method POST
body
{
"access_token": {access_token},
"task_id": 1, //必填
"class_id": 12, //必填
"action": "开始实验" //必填
}response
{
"status": 0,
"message": 'ok'
}获取任务行为数据
url /task/actions
method GET
query
{
"access_token": {access_token},
"task_id": {task_id}, //必填
"class_id": 123 //必填
}response
{
"status": 0,
"message": 'ok',
"data": [{
"action_time": 140233403404, //时间戳
"action_describe": "开始实验"
}, {
"action_time": 140233403404,
"action_describe": "操作电路板"
}, {
"action_time": 140233403404,
"action_describe": "调整电路板"
},{
"action_time": 140233403404,
"action_describe ":"提交实验数据"
},{
"action_time": 140233403404,
"action_describe":"结束实验"
}]
}上传（提交）任务报告数据
url /task/data
method POST
body
{
"access_token": {access_token},
"finished": 1, //0:暂存，1:完成实验(即提交)
"task_id": "xxxxxx", //必填
"class_id": 12, //必填
"partners": [{ //实验成员
"id": 1,
"name": "abc"
}, {
"id": 23,
"name": "cba"
}],
"attachment": [ //附件，可选
{
"id": "xxxx",
"url": "http://xxxx"
"size": 12212,
"originalname": "filename"
}
],
"data": [{ //实验数据，每个{}是一个group
"title": "仿真实验",
"content": [{
"type": "image", //取值：image图片，text文字，wave波形数据
"value": "http://img.kanzhun.com/images/logo/20150906/f4ff637d692de37199c8665cf70746fa.jpg"
}, {
"type": "text",
"value": "分布式的部分可使肌肤看电视不发顺丰不数据库的"
}]
}, {
"title": "波形数据",
"content": [{
"type": "wave",
"chart": [{
"unit": ["s", "V"],
"axis": [[0, 0], [0.2, 0.12533323356430426], [0.4, 0.24868988716485482], [0.6, 0.36812455268467797], [0.8, 0.48175367410171532]]
}, {
"unit": ["s", "V"],
"axis": [[0, 0], [0.2, 0.080000000000000002], [0.4, 0.16, 0.24000000000000002], [0.8, 0.32000000000000001], [1.6, 0.40000000000000002]]
}]
}]
}]
}response
{
"status": 0,
"message": 'ok'
}获取任务报告数据
url /task/data
method GET
query
{
"access_token": {access_token},
"task_id": "xxxx", //必填
"class_id": 123, //必填
"student_id": 123 //可选
}response
{
"status": 0,
"message": 'ok',
"data": {
"id": "xxxxx",
"class_id": 123,
"task_id": "xxxxx",
"finished": 1, //0:未完成， 1：已完成
"partners": [{
"id": 1,
"name": "李磊"
}，{
"id": 2,
"name": "韩梅梅"
}],
"attachment": [ //附件，可选
{
"id": "xxxx",
"url": "http://xxxx"
"size": 12212,
"originalname": "filename"
}
],
"finish_time": 1479806204, //报告完成时间
"created_time": 1479806204, //首次提交报告时间
"score": -1, //-1: 未批改，0及以上为已批改的得分
"data": [{ //任务数据，每个{}是一个group
"title": "仿真实验",
"content": [{
"type": "image", //取值：image图片，text文字，wave波形数据
"value": "http://img.kanzhun.com/images/logo/20150906/f4ff637d692de37199c8665cf70746fa.jpg"
}, {
"type": "text",
"value": "分布式的部分可使肌肤看电视不发顺丰不数据库的"
}]
}, {
"title": "波形数据",
"content": [{
"type": "wave",
"chart": [{
"unit": ["s", "V"],
"axis": [[0, 0], [0.2, 0.12533323356430426], [0.4, 0.24868988716485482], [0.6, 0.36812455268467797], [0.8, 0.48175367410171532]]
}, {
"unit": ["s", "V"],
"axis": [[0, 0], [0.2, 0.080000000000000002], [0.4, 0.16, 0.24000000000000002], [0.8, 0.32000000000000001], [1.6, 0.40000000000000002]]
}]
}]
}],
"finished": 1
}
}获取同班同学 url /task/get_classmates
method GET
query
{
"access_token": {access_token},
"task_id": {task_id}, //必填
"class_id": 123 //必填
}response
{
"status": 0,
"message": 'ok',
"data": {
"available": [{
"user_id"：3，
"name":"ABCDED",
"avatar": "asdgasdfasdf.jpg"
},{
"user_id"：97，
"name":"ABCDED",
"avatar": "asdgasdfasdf.jpg"
}],
partners: [{
"user_id"：27，
"name":"ABCDED",
"avatar": "asdgasdfasdf.jpg"
}]
}
}查看任务完成情况
url /task/achieve
method GET
query
{
"access_token": {access_token},
"task_id": {$task_id}, //必填
"class_id": {$class_id} //必填
}response
{
"status": 0,
"data": {
"finished": [{
"uid": 332,
"name": "huangsuoyuan",
"avatar": "http://wx.qlogo.cn/mmopen/tnGT4YBoSbYzZWtK6Vxia7kricg3lCX5wBiatXNENEaQLgL5987viceCsiaXzSTQ4m4QceKOthibUMUlacIT3KkaTx9cFiaJ38eOQRD/0",
"finish_time": 1487907798
}],
"unfinished": [{
"uid": 332,
"name": "huangsuoyuan",
"avatar": "http://wx.qlogo.cn/mmopen/tnGT4YBoSbYzZWtK6Vxia7kricg3lCX5wBiatXNENEaQLgL5987viceCsiaXzSTQ4m4QceKOthibUMUlacIT3KkaTx9cFiaJ38eOQRD/0",
"created_time": 1487907798
}],
"unstarted": [{
"uid": 332,
"name": "huangsuoyuan",
"avatar": "http://wx.qlogo.cn/mmopen/tnGT4YBoSbYzZWtK6Vxia7kricg3lCX5wBiatXNENEaQLgL5987viceCsiaXzSTQ4m4QceKOthibUMUlacIT3KkaTx9cFiaJ38eOQRD/0"
}]
}
}老师打分
url /task/mark
method POST
body
{
"access_token": {access_token},
"task_id": {$task_id}, //必填
"class_id": 12, //必填
"student_id": {student_id}, //必填
"score": 90 //必填
}response
{
"status": 0,
"message": 'ok'
}上传图片
url /upload
method POST
header Content-Type: multipart/form-data
body
{
"access_token": {access_token},
"task_id": {$task_id},
"file": {$file}
}response
{
"status": 0,
"message": 'ok',
"data": {
"id": "58847e9c2444b91a49845494",
"mimetype": "image/jpeg",
"size": 12212,
"url": "http://img.kanzhun.com/images/logo/20150906/f4ff637d692de37199c8665cf70746fa.jpg",
"originalname": "filename"
}
}获取我的任务
url /user/my_task/
method GET
query
{
"access_token": {access_token},
"role": "student" //角色取值为[teacher, student]
}response
{
"status": 0,
"message": "ok",
//========教师身份========
"data": {
"courses": [{ //下面的课程
"classrooms": [{ //该课程下面的班级
"students_count": 8,
"id": 2509, //班级id
"name": "658" //班级名
}],
"name": "吧123", //课程名
"id": 217 //课程id
}, {
"classrooms": [{
"students_count": 4,
"id": 2407,
"name": "测试"
}, {
"students_count": 2,
"id": 2464,
"name": "1"
}],
"name": "多选投票测试",
"id": 159
}],
"tasks": [{ //创建的任务
"task_id": "xxxx",
"name": "xxxx",
"created_time": 1479955316,
"publish": [
{
"class_id": 2470,
"publish_time": 1510564211,
"deadline": 1402341250
},
{
"class_id": 2472,
"publish_time": 1510564211,
"deadline": 1402341250
}
]
}]
},
//======学生身份======
"data": [{ //课程
"id": 11,
"name": "课程",
"classrooms": [{ //班级
"id": 2500,
"name": "还把",
"tasks": [ //实验数据
{
"task_id": "582d79f909d8fd4cc56fe7c7",
"name": "测试实验",
"deadline": 1479955316,
"finished": 1,
"score": 60,
"publish_time": 1479720278
}, {
...
}
]
}, {
...
}]
}, {
...
}]
}创建班级
url /user/new_classroom
method POST
body
{
"access_token": {access_token},
"classroom": "班级名称",
"course_id": 123, //课程id，该字段跟course_name2选1，在已有课程下创建班级用course_id，新创建课程用course_name
"course_name": "课程名称"
}response
{
"status": 0,
"message": "正确",
"data": {
"classroom_id": 4398, //创建的班级id
"classroom_name": "c", //创建的班级名称
"course_id": 192, //课程id
"course_name": "天体物理" //课程名称
}
}微信相关轮询接口
url /wechat/confirm
method GET
query
{
"access_token": {access_token},
"event": "SCAN/MEDIA",
"event_type": "IMAGE",
"media_id": "xxx" //可选，如果拍了多张照片可以用,分割response
{
"status": 0, //当event是SCAN时判断此字段即可
"message": 'ok',
"data": [{ //当event是MEDIA时
"status": 0, //0.成功；1.失败;
"media_id": "xxxx", //可选
"url": "http://img.kanzhun.com/images/logo/20150906/f4ff637d692de37199c8665cf70746fa.jpg" //可选
}, {
"status": 1,
"media_id": "xxxx"
}]
}推送微信
批改实验报告
domain ws://b.xuetangx.com/openws/
出二维码
message
{
"op": "login"
"code": {code},
"appid": {appid},
"nonce": {nonce} //随机数
}response
{
"op": "login",
"status": 0,
"message": "success",
"loginid": 222,
"expire_seconds": 60,
"ticket": "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQHk8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL216b0pHV1RseEZHOTZrdjYweFQzAAIEVoYJWAMEAI0nAA==",
"url": "http://weixin.qq.com/q/mzoJGWTlxFG96kv60xT3"
}通知扫码成功
response
{
"op": "loginsuccess",
"status": 0,
"message": "success",
"loginid": 222,
"UserID": "int型用户id如123",
"Name": "用户名字",
"Nickname": "微信昵称",
"Avatar": "微信头像的url地址,http://wx.qlogo.cn/mmopen/tnGT4YBoSbbUZmECibSLnDu2z5r2bpbDtH7zAiadRETvU8bQlTR8ObiapVUlaejbOiafmOkM8my6Q5NZ3dC3ACHIxIGKL27fxYG0/0",
"WeixinUnionID": "微信的unionid,owHdquIH-AdQD7UMPohiIaQGjfA8",
"AppOpenID": "用户针对此公众号的appid默认为none,oM_HWwYUcgHV9ewbAt76kWSeoL3g",
"School": "所在院校",
"Department": "所在院系",
"Role": "身份,默认为0:0未填写1在校学生2老师3其他人员",
"Position": "职别信息，默认为空",
"YearOfBirth": "出生年份,datetime格式日期",
"Gender": "性别,默认为0:0未填写1男2女",
"LastLoginIP": "上次登录ip,如127.0.0.1",
"DateJoined": "帐号注册时间datetime时间,%Y-%m-%dT%H:%M:%S格式",
"LastLogin": "上次登录时间datetime时间,%Y-%m-%dT%H:%M:%S格式",
"Auth": "uuid的加密,str类型", //后续接口中的access_token
"Beta": {"DownloadURL": "http://b.xuetangx.com", "ChangeLog": "beta1.0.0.25\u7248", "Version": "1.0.0.25", "LaunchDate": "2016-03-31T16:15:41"},
"Stable": {"DownloadURL": "http://rain.xuetangx.com/", "ChangeLog": "\u6295\u7968\u6700\u591a\u53ef\u9009\u9879\u6570\u76ee\u4e0d\u4e00\u81f4\u4fee\u6539", "Version": "1.0.0.39", "LaunchDate": "2016-05-10T09:52:10"}
}