Refresh Access Token¶
使用 Refresh Token 请求一个新的 Access Token。
请求参数(URI)¶
名称 | 位置(Path/Query) | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|---|
refreshToken | Query | 必需 | String | Refresh Token。参阅 Choose Organization 获取 Refresh Token。 |
响应参数¶
名称 | 数据类型 | 描述 |
---|---|---|
data | List<JSONObject> | 登录用户信息。详见 登录用户信息结构体 |
登录用户信息结构体 ¶
名称 | 数据类型 | 描述 |
---|---|---|
userId | String | 用户ID。 |
userName | String | 用户名。 |
workingOrganizationId | String | 当前组织ID。 |
workingOrganizationName | String | 当前组织名称。 |
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
}
}