生成AccessToken
API 名称
base/create-access-token,用于SDK权限校验,针对文档服务。如果您同时集成多个服务,可在入参时传入相应服务的权限值,具体权限值可参考个服务的参数描述。
入参
参数 |
类型 |
是否必选 |
含义 |
third_party_user_id |
string |
是 |
第三方用户ID |
expire_time |
string |
否 |
过期时间 默认为一天,最大为一天 格式为 2017/01/01 00:00:00 |
operate_document |
string |
否 |
演示文档操作权限,对应的值为频道ID(通过消息API 创建频道接口获得) |
参数示例
{
third_party_user_id : "vhall_user_nelsonking", // 第三方用户ID
expire_time : 2017/01/01 00:00:00, // 过期时间
operate_document : "ch_2ca93b03,ch_eb493b22",// 文档操作:“频道ID”
}
// 多个频道ID,请使用英文逗号分割
// 需要多个服务时,可传入对应权限,权限列表可有多个,无先后顺序
// 各权限可对应多个资源ID,请使用英文逗号分割
出参
参数 |
类型 |
是否必选 |
含义 |
access_token |
string |
是 |
token 令牌 |
错误码
错误码 |
类型 |
含义 |
10012 |
int |
第三方用户ID不能为空 |
40004 |
int |
时间类型不正确 |
40003 |
int |
没有该权限类型 频道ID |
30006 |
int |
不是这些频道拥有者 |
响应格式
{
"code": 200,
"msg": "",
"data": {
"access_token": ""
}
}
销毁AccessToken
API 名称
base/destroy-access-token
入参
参数 |
类型 |
是否必选 |
含义 |
access_token |
string |
是 |
访问令牌 |
出参
参数 |
类型 |
是否必选 |
含义 |
destory_token |
string |
是 |
销毁的AccessToken |
错误码
响应格式
{
"code": 200,
"msg": "",
"data": [
"destory_token" : "access:app_id_1:jfalsiecnm"
]
}