获取通道 token v1
最近更新:2022-5-21
获取通道 token v1
API 概述
功能说明
对于使用 AppID秘钥的方式进行鉴权的通道,提供API获取已获取的token,开发者业务系统可以使用UMS系统做token池,向UMS获取token,即可避免token冲突问题。
如果企业的业务系统已经自行接入了微信公众号/小程序业务,希望 UMS 在使用微信公众号/小程序时不要与业务系统产生冲突(token、获取统计数据),则可以在创建通道时,选择使用扫码授权的方式进行。
调用地址
GET https://api.ums.jiguang.cn/v1/token?type={type}
调用验证
HTTP Header(头)里加一个字段( Key/Value 对):
Authorization: Basic base64_auth_string
Authorization: Basic base64_auth_string
此代码块在浮窗中显示
其中 base64_auth_string 的生成算法为:base64(ChannelKey:MasterSecret)
即,对 ChannelKey 加上冒号,加上 MasterSecret 拼装起来的字符串,再做 base64 转换。
请求参数
type为所需要获取的通道的类型,通过渠道鉴权,可以取到本渠道授权的通道的token值。type 的取值说明如下
wechatoa 微信公众号
wechatmp 微信小程序
dingtalkcc 钉钉
wechatwk 企业微信
wechatoa 微信公众号
wechatmp 微信小程序
dingtalkcc 钉钉
wechatwk 企业微信
此代码块在浮窗中显示
返回参数
参数 | 类型 | 选项 | 说明 |
---|---|---|---|
code | int | 必填 | 业务返回码,成功为为 0 |
token | String | 必填 | 该通道的token值 |
expires_in | String | 必填 | 有效时间,单位:秒 |
message | string | 必填 | 业务返回详情,成功是为 success,失败时将返回具体的失败原因 |
成功时:
{
"code":0,
"token":"token",
"expires_in":"7000"//有效时间,单位:秒
}
{
"code":0,
"token":"token",
"expires_in":"7000"//有效时间,单位:秒
}
此代码块在浮窗中显示
失败时:
{
"code":5000,
"message":"错误信息"
}
{
"code":5000,
"message":"错误信息"
}
此代码块在浮窗中显示
文档内容是否对您有帮助?