生成AccessToken
API 地址
api.yun.vhall.com/api/v1/base/create-access-token
描述
用于SDK权限校验,accessToken即权限,调用接口生成accessToken将传入SDK,SDK在请求时会附带accessToken,
SDK将按您赋予的权限进行相关的权限验证,如果您同时集成多个服务,可在入参时传入相应服务的权限值
入参
参数 |
类型 |
是否必选 |
含义 |
third_party_user_id |
string |
是 |
第三方用户ID |
expire_time |
string |
否 |
过期时间 默认为一天,最大为一天 格式为 2017/01/01 00:00:00 |
publish_stream |
string |
否 |
推流权限 对应房间ID (通过直播API 创建房间接口获得) |
chat |
string |
否 |
发聊天权限 对应频道ID (通过消息API 创建频道接口获得) |
operate_document |
string |
否 |
演示文档操作权限 对应频道ID (通过消息API 创建频道接口获得) |
参数示例
{
third_party_user_id : "vhall_user_nelsonking", // 第三方用户ID
expire_time : 2017/01/01 00:00:00, // 过期时间
publish_stream : "lss_af793b0e,lss_b328234c", // 推流: “房间ID”
chat : "ch_af793b0e,ch_cb593b12",// 发聊天: “频道ID”
operate_document : "ch_2ca93b03,ch_eb493b22",// 演示文档操作: “频道ID”
}
// 各权限对应的值为其权限类别的资源ID
// 权限列表可有多个,无先后顺序
// 多个资源ID,请使用英文逗号分割
出参
参数 |
类型 |
是否必选 |
含义 |
access_token |
string |
是 |
token 令牌 |
错误码
错误码 |
类型 |
含义 |
10012 |
int |
第三方用户ID不能为空 |
40004 |
int |
时间类型不正确 |
40003 |
int |
没有该权限类型 资源ID |
30005 |
int |
不是这些房间拥有者 房间ID |
30006 |
int |
不是这些频道拥有者 |
响应格式
{
"code": 200,
"msg": "",
"data": {
"access_token": ""
}
}