华辰用户授权

微录播 华辰

更新历史

目录

1. 全局返回码说明

HTTP请求状态返回格式

错误样例
{
"success": false,
"mgs": "invalid appid"
}
成功样例
{
"success": true,
"data": {"access_token":"ACCESS_TOKEN","expires_in":7200}
}

1.用户授权

1.1 获取用户授权信息

接口地址

/licence/info

HTTP Content-Type

application/json

请求方式

GET

请求参数

参数	必选	类型	说明
QueryParams
to_uid	是	string	被授权用户ID
nick_name	是	String	被授权用户昵称

HTTP 响应状态

200

Data Item

Category Item

Data Item

接口示例

Request
curl -X GET http://localhost/license/info?to_uid=xxxx&nick_name=xxxxx
Response
{"success":true,"data":{ to_uid: 'xxxx1',
expire_time: '2019-02-24',
nick_name: 'xxxx',
max_count: 20,
current_count: 0,
categorys:
[ { cid: '1', cname: '分类1', status: 1, data: [{sub_cid:'11',sub_cname:'xxxxx',status:1}] },
{ cid: '2', cname: '分类2', status: 0, data: [{sub_cid:'12',sub_cname:'xxxxx',status:1}] } ]}
}

1.2 添加/修改用户授权信息

接口地址

/licence/update

HTTP Content-Type

application/json

请求方式

POST

请求参数

参数	必选	类型	说明
RequestBody
参数如接口【获取用户授权信息】返回结果中Data结构	是	Object	JSONObject结构的授权信息

HTTP 响应状态

200

接口示例

Request
curl -X POST -H "Content-Type:application/json" -d { to_uid: 'xxxx1',
expire_time: '2019-02-24',
nick_name: 'xxxx',
max_count: 20,
categorys:
[ { cid: '1', cname: '分类1', status: 1, data: [{sub_cid:'11',sub_cname:'xxxxx',status:1}] },
{ cid: '2', cname: '分类2', status: 0, data: [{sub_cid:'12',sub_cname:'xxxxx',status:1}] } ]} http://localhost/licence/update
Response
{
"success": true,
}

1.3 检查用户授权

接口说明

检查用户在指定课程的授权情况和播放限制

接口地址

/licence/check

HTTP Content-Type

application/json

请求方式

GET

请求参数

参数	必选	类型	说明
QueryParams
to_uid	是	String	被授权用户ID
cid	否	String	一级分类ID
sub_cid	否	String	二级分类ID

HTTP 响应状态

200

接口示例

Request
curl -X GET http://localhost/licence/check？to_uid=xxxx
Response
{
"success": true
}

2 分类

2.1 获取分类信息

接口说明

在原接口上增加返回二级分类信息

接口地址

/square/subjects

HTTP Content-Type

application/json

请求方式

GET

请求参数

参数	必选	类型	说明
QueryParams

无

HTTP 响应状态

200

接口示例

Request
curl -X GET http://localhost/licence/check？to_uid=xxxx
Response
{"status":true,"subjects":[{"name":"国考","code":"762","avatar":"http://vztsd.sewise.com/icons/icon_lawer.png","data":[{"sub_name":"基础","sub_code":"798","sub_avatar":null,"id":"85","kind":6},{"sub_name":"强化","sub_code":"799","sub_avatar":null,"id":"85","kind":6},{"sub_name":"冲刺","sub_code":"800","sub_avatar":null,"id":"85","kind":6}]}]}

3 课程

3.1 提交课程

接口说明

接口扩展，提交增加二级分类信息

接口地址

/course

HTTP 请求方式

POST

请求参数

参数	必选	类型	说明
username	是	string	用户名称
userType	是	int	用户类型
local	否	int	local=1表示微录播主机可见，local=0表示云空间不可见
nickname	是	string	用户昵称
courseid	否	string	课程id；修改时必传
poster	否	string	封面
summary	否	string	简介
grade	否	string	年级；（大学时为科目）
subject	否	string	学科；(大学时为科目下的专业)
subject_category	否	string	(大学时)学科分类
title	否	string	标题
sn	否	string	微录播主机sn
mark	否	string	标记
freeTime	否	string	免费时间
price	否	string	价格
sub_subject	否	String	二级学科分类

HTTP 响应状态

200

3.2 获取机构课程总数

接口说明

接口地址

/course/counts

HTTP Content-Type

application/json

请求方式

GET

请求参数

参数	必选	类型	说明
QueryParams

无

HTTP 响应状态

200

接口示例

Request
curl -X GET http://localhost/course/counts
Response
{"success":true,"data":{"counts":1}}

3.3 获取购买的课程

接口地址

/square/myBuyCourse

HTTP Content-Type

application/json

HTTP 请求方式

GET

HTTP 响应状态

200

请求参数

RequestBody

参数	必选	类型	说明
page	否	string	页数，默认为1
size	否	string	一页显示数量，默认为3
userinfo	是	json	用户登陆信息

接口示例

Request
url: http://ip:port/square/experts
Response
{"success":true,"data":{"data":[{"courseid":'xxx',name:'xxx',count:'xx'}],"total":1,"totalPage":1}}}