令牌刷新


接口说明

只有当访问令牌失效后,通过未失效的刷新令牌去调用刷新接口,才能拿到新的授权令牌数据。如果访问令牌未失效,调用接口拿到的依旧是当前生效中的授权令牌数据

基本信息

请求方式: 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 接口响应数据业务说明,调用失败时为相应的错误说明

results matching ""

    No results matching ""