Appearance
刷新 access_token
使用
refresh_token刷新access_token
接口
/token/refreshToken
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| name | String | 是 | token.refreshToken | 调用的 API 接口名称 |
| appKey | String | 是 | 2w42E9JBF8hBSg3m4MmzqQ | 应用创建完成后被分配的 key |
| timestamp | String | 是 | 1742621225 | 时间戳,格式为 10 位时间戳,时区为 GMT+8 |
| version | String | 是 | 1 | API 协议版本 |
| data | String | 是 | %7b%22appKey%22%3a%22... | 标准 json 类型经 URL 编码,里面是业务参数。此处解码后对应参数为 appKey 和 refreshToken |
| sign | String | 是 | 480F2F3CEC131AB0209D3C76BE1CF4B0 | 输入参数签名结果 |
| accessToken | String | 是 | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... | 访问令牌 |
请求示例
json
{
"name": "token.refreshToken",
"appKey": "2w42E9JBF8hBSg3m4MmzqQ",
"timestamp": "2025-03-12 21:54:37",
"version": "1",
"data": "%7b%22appKey%22%3a%222w42E9JBF8hBSg3m4MmzqQ%22%2c%22refreshToken%22%3a%2249694e4d-d5ee-420f-8c5d-b130f44089ed%22%7d",
"sign": "480F2F3CEC131AB0209D3C76BE1CF4B0",
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwZXJtaXNzaW9uIjoiMSwyLDMiLCJleHAiOjE3NDE3ODc1OTEsImlhdCI6MTc0MTc4MDM5MX0.DkTbj6bOxSkrHTcYcvH5KsDiMUJKQoW2FOYq8Fo4-5U"
}业务参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appKey | String | 是 | 2w42E9JBF8hBSg3m4MmzqQ | 应用创建完成后被分配的 key |
| refreshToken | String | 是 | 2w42E9JBF8hBSg3m4MmzqQ | 用于刷新 access_token 的刷新令牌;有效期 7 天 |
响应参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| success | Boolean | 是 | TRUE | 表示操作是否成功 |
| message | String | 是 | 操作成功! | 操作的结果提示信息 |
| code | Integer | 是 | 200 | 返回码,通常 200 表示成功 |
| result | Object | 是 | { "accessToken": "...", "refreshToken": "..." } | 包含访问令牌和刷新令牌的结果对象 |
| result.accessToken | String | 是 | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... | 新的访问令牌 |
| timestamp | Integer | 是 | 1741780916923 | 响应生成的时间戳,单位为毫秒 |
在线调试
API 调试工具GET/POST
响应示例
json
{
"success": true,
"message": "操作成功!",
"code": 200,
"result": {
"name": null,
"appKey": null,
"timestamp": null,
"version": null,
"data": null,
"sign": null,
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwZXJtaXNzaW9uIjoiMSwyLDMiLCJleHAiOjE3NDE3ODgxMTYsImlhdCI6MTc0MTc4MDkxNn0.fbRbMMSCu4r5t-zFQvYcFdrX6AhxP5_6idqMUOfx22s",
"refreshToken": null
},
"timestamp": 1741780916923
}