只有当访问令牌失效后,通过未失效的刷新令牌去调用刷新接口,才能拿到新的授权令牌数据。如果访问令牌未失效,调用接口拿到的依旧是当前生效中的授权令牌数据
请求方式: POST
请求地址:https://sso-center.myyscm.com/v2/token/refresh
| 参数名 | 参数位置 | 参数类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|---|
| refreshToken | Body | String | 是 | 刷新令牌 | |
| appid | Body | String | 是 | 应用在星图的 AppKey | |
| nonce | Body | String | 是 | 用于签名的随机字符串,调用方自己生成,建议字符串长度不超过 32 个字符 | |
| timestamp | Body | Number | 是 | 用于签名的时间戳,发起接口调用时的时间戳值 | |
| signature | Body | String | 是 | 根据参数生成的签名,参与签名的参数有 refreshToken、appid、appKey、nonce、timestamp |
POST
https://sso-center.myyscm.com/v2/token/refresh
{
"refreshToken": "5dQlGaYsGcCcdrYLWCzobxjcCqWBXqit",
"appid": "TjqhxiyUEkYt5beLfek1bxBMvF8zMtrZ",
"nonce": "48df49bfd592c5f36396aaaf2c399ab5",
"timestamp": 1607914459,
"signature": "7d9d1e934efc51ab0bc45ae36590258ad5d436f7"
}
{
"errcode": 0,
"message": "Success",
"data": {
"accessToken": "iyJ9P2Tcl5OK5Aom74do28xuBFHky74h",
"refreshToken": "5dQlGaYsGcCcdrYLWCzobxjcCqWBXqit",
"expireTime": 7093,
"refreshTime": 2591893
}
}
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| data.accessToken | String | 访问令牌 |
| data.refreshToken | String | 刷新令牌 |
| data.expireTime | Number | 访问令牌剩余的有效时间,默认 2 小时(单位:秒) |
| data.refreshTime | Number | 刷新令牌剩余的有效时间,默认 30 天(单位:秒) |
{
"errcode": 10001,
"message": "Failure message."
}
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| errcode | Number | 业务错误码,0 正常,非 0 均为发生业务错误 |
| message | String | 接口响应数据业务说明,调用失败时为相应的错误说明 |