请登录后查看
CheckToken
校验Token
该接口提供校验token合法性功能。服务器收到请求后,验证token合法性并返回结果。如果参数needGenNewToken为true时,生成新的token并返回。
名称 | 类型 | IN | 必选 | 描述 |
---|---|---|---|---|
Accept-Language | string | header | 否 | 语言参数,默认为中文zh-CN,英文为en-US。 |
X-Request-ID | string | header | 否 | 请求requestId,用来标识一路请求,用于问题跟踪定位,建议使用UUID,若不携带,则后台自动生成。 |
Content-Type | string | header | 是 | Body的媒体格式。
|
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
token | string | 是 | Access Token。 |
needGenNewToken | boolean | 是 | 是否生成新的Token。
|
needAccountInfo | boolean | 否 | 是否需要返回用户帐号信息(帐号、用户名称等信息)。 |
操作成功。
名称 | 类型 | 描述 |
---|---|---|
accessToken | string | Access Token字符串。 |
tokenIp | string | 用户IP。 |
validPeriod | long | Access Token有效时长,单位:秒。 |
expireTime | long | Access Token的失效时间戳,单位:秒。 |
createTime | long | Access Token的创建时间戳,单位:毫秒。 |
user | UserInfo object | 用户鉴权信息。 |
clientType | integer | 登录帐号类型。
|
forceLoginInd | integer | 抢占登录标识。
|
firstLogin | boolean | 是否首次登录。
|
pwdExpired | boolean | 密码是否过期,默认值:false。 |
daysPwdAvailable | integer | 密码有效天数。 |
proxyToken | ProxyTokenDTO object | 代理鉴权信息。 |
delayDelete | boolean | 是否延时删除状态。 |
tokenType | integer | Token类型。
|
refreshToken | string | Refresh Token字符串。 |
refreshValidPeriod | long | Refresh Token有效时长,单位:秒。 |
refreshExpireTime | long | Refresh Token的失效时间戳,单位:秒。 |
refreshCreateTime | long | Refresh Token的创建时间戳,单位:毫秒。 |
名称 | 类型 | 描述 |
---|---|---|
userId | string | 用户UUID。 |
ucloginAccount | string | 华为云会议帐号。 |
serviceAccount | string | 用户关联的SIP号码。 |
numberHA1 | string | 号码对应的HA1。 |
alias1 | string | 用户别名。 |
companyId | string | 用户归属的企业ID。 |
spId | string | 用户所在企业归属的SP ID。 |
companyDomain | string | 企业域名。 |
realm | string | 本地鉴权。 |
userType | integer | 用户类型。
|
adminType | integer | 管理员类型。
|
name | string | 用户名称。 |
nameEn | string | 用户英文名称。 |
isBindPhone | boolean | 标识是否绑定手机。 |
freeUser | boolean | 标识是否是免费试用用户。 |
thirdAccount | string | 第三方的用户帐号。 |
visionAccount | string | 智慧屏设备ID。 |
headPictureUrl | string | 头像链接。 |
password | string | 机机密码,用于智慧屏登录。 |
status | integer | 用户状态。
|
paidAccount | string | 付费用户机机帐号,用于智慧屏登录。 |
paidPassword | string | 付费用户机机密码,用于智慧屏登录。 |
weLinkUser | boolean | 标识是否是WeLink用户。 |
appId | string | 应用ID。 |
tr069Account | string | tr069帐号。 |
corpType | integer | 企业类型。
|
cloudUserId | string | 华为云帐号ID。 |
grayUser | boolean | 标识是否是灰度用户。 |
名称 | 类型 | 描述 |
---|---|---|
accessToken | string | 代理鉴权服务器的短token字符串。 |
longAccessToken | string | 代理鉴权服务器的长token字符串。 |
validPeriod | long | Token有效时长,单位:秒。 |
middleEndUrl | string | 中台地址。 |
middleEndInnerUrl | string | 中台内网地址。 |
enableRerouting | boolean | 是否开启二次路由。 |
参数异常。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
未鉴权或鉴权失败。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
服务端异常。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
"POST https://{endpoint}/v1/usg/acs/token/validate"
{
"token": "stbNYluHvordsmyF2Ubt271qDr6WDAVLtLRb",
"needGenNewToken": false,
"needAccountInfo": true
}
操作成功。
{
"accessToken": "stbc3SRoXXZhsuw4XXXXX.....",
"tokenIp": "10.8.0.90",
"validPeriod": 84616,
"expireTime": 1577979513,
"createTime": 1599102826754,
"user": {
"realm": "huaweicloud.com",
"userId": "0d5202707123429d876....",
"ucloginAccount": "p-53df7b9046ae41efa75e82e08bfe9181",
"serviceAccount": "sip:+99111210335819378@huaweicloud.com",
"numberHA1": "1ead5e5ce44849bc2718d5c....",
"alias1": null,
"companyId": "f5968fc4f9c14d50905e8e66672dabc6",
"spId": "666bd8558e4646e1a7e1a0c99cf898e8",
"companyDomain": null,
"userType": 2,
"adminType": 2,
"name": "张三",
"nameEn": null,
"isBindPhone": null,
"freeUser": false,
"thirdAccount": "zhangsan@yourcorp.com",
"visionAccount": null,
"headPictureUrl": null,
"password": null,
"status": 0,
"paidAccount": null,
"paidPassword": null,
"weLinkUser": false,
"appId": null,
"tr069Account": "",
"corpType": 0,
"cloudUserId": "76aaaba8a12f4c0a8a43192...",
"grayUser": false
},
"clientType": 72,
"forceLoginInd": null,
"firstLogin": true,
"pwdExpired": false,
"daysPwdAvailable": -18172,
"proxyToken": null,
"delayDelete": false,
"tokenType": 0,
"refreshToken": "stbYaza5VVRr3IGuLSs6ZvF0lMHHvGO0tQ0f",
"refreshValidPeriod": 2592000,
"refreshExpireTime": 1601694826,
"refreshCreateTime": 1599102826754
}