鉴权登陆
鉴权登陆接口,主要是用于根据用户提供的信息登陆全时云直播系统,并获取系统的统一鉴权标志串:token,(请妥善保存token, 丢失token可能会造成他人在token有效期内使用接口修改数据)如果出现token丢失,请及时调用鉴权接口中的token失效方法,保证数据的安全性。
全时云直播提供的所有开放接口,都需要将token作为参数传递给对应的接口,用于对调用方身份的校验。(虽然全时云直播支持多种token的传递方式,但出于安全考虑,建议用户将token放置在请求头中)
在获取token时,需要提供调用者的手机和国家码信息,请确保提供的电话信息可以在全时系统中查询到,并能正确获取到对应的UMSID。电话信息的正确性是确保能够正常预约会议的关键因素
新建token
1. 接口描述
接口名称:
/eventopenapi/token/create
发送方式:
POST
参数格式:
accept: application/json;content-type: application/json
Http Headers
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
AppKey | String | 是 | 开发者平台分配的AppKey |
Nonce | String | 是 | 随机数(随机数,最大长度128个字符) |
CurTime | String | 是 | 当前UTC时间戳,从1970年1月1日0点0分0秒开始到现在的毫秒数 |
CheckSum | String | 是 | 服务器认证需要,16进制字符小写SHA1(AppSecret+Nonce+CurTime) |
2. 输入参数
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
userId | Long | 是 | 管理员帐号ID(开通账号时会提供管理员的UMSID,如果没有可以通过 https://developer.quanshi.com/cn/api/122 查询) |
userName | String | 否 | 管理员帐号名称 |
3. 输出参数
参数 | 类型 | 说明 |
---|---|---|
timeStamp | Long | 返回时间(时间戳,单位毫秒) |
requestId | String | 请求ID(在接口异常时, 需提供请求ID) |
code | Int | 返回的状态码 |
msg | String | 当返回结果的状态码不为200时,包含的错误信息 |
data | Json | 返回数据 |
data 参数说明
参数 | 类型 | 说明 |
---|---|---|
token | String | 统一鉴权token |
userId | Long | 帐号ID |
userName | String | 帐号名称 |
expire | Int | token有效时长(时间戳,单位秒) |
createTime | Long | token创建时间(时间戳,单位毫秒) |
productId | Long | 产品ID |
customerCode | String | 客户编码 |
4. 示例
输入示例
{
"userId": 88408809,
"userName": "管理员测试账号"
}
输出示例
{
"timeStamp": 1639470773358,
"code": 200,
"msg": "Successfully to create the token!",
"data": {
"productId": 80,
"createTime": 1639470773241,
"expire": 86400,
"customerCode": "153857",
"userName": "云活动测试账号151",
"userId": 88408809,
"token": "5d41c4ac806c6440eb6aa8e071115f2b"
},
"requestId": "10.255.0.106_20211214_163252_1639470772926"
}