Refresh Access Token¶

使用 Refresh Token 请求一个新的 Access Token。

请求格式¶

GET https://{apigw-address}/app-portal-service/v2.2/token/refresh

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
refreshToken	Query	必需	String	Refresh Token。可通过 Choose Organization API 获取 Refresh Token。

响应参数¶

名称	数据类型	描述
userId	String	用户 ID。
userName	String	用户名。
workingOrganizationId	String	当前 OU ID。
workingOrganizationName	String	当前 OU 名称。
accessToken	String	刷新后的 Access Token。
refreshToken	String	可用于刷新 Access Token 的 Refresh Token。
refreshTokenExpire	Long	Refresh Token 的过期时间。以 UTC 时间表示，格式见 UTC 采用的 ISO8601 标准时间格式。

错误码¶

代码	错误信息	描述
31400	Refresh Token is required	Refresh Token 不能为空
31401	Please login first	请先登录，获取正确的 Access Token 和 Refresh Token

示例¶

请求示例¶

url: https://{apigw-address}/app-portal-service/v2.2/token/refresh?refreshToken=yourRefreshToken

method: GET

返回示例¶

{
  "code": 0,
  "message": "OK",
  "data": {
    "userId": "your_user_id",
    "userName": "your_user_name",
    "workingOrganizationId": "your_org_id",
    "workingOrganizationName": "your_org_name",
    "accessToken": "your_access_token",
    "refreshToken": "your_refresh_token",
    "refreshTokenExpire": 1571368315000
  }
}