Skip to content

刷新 access_token

使用refresh_token刷新access_token

接口

  • /token/refreshToken

公共参数

参数名称参数类型是否必须示例值参数描述
nameStringtoken.refreshToken调用的 API 接口名称
appKeyString2w42E9JBF8hBSg3m4MmzqQ应用创建完成后被分配的 key
timestampString1742621225时间戳,格式为 10 位时间戳,时区为 GMT+8
versionString1API 协议版本
dataString%7b%22appKey%22%3a%22...标准 json 类型经 URL 编码,里面是业务参数。此处解码后对应参数为 appKey 和 refreshToken
signString480F2F3CEC131AB0209D3C76BE1CF4B0输入参数签名结果
accessTokenStringeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...访问令牌

请求示例

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"
}

业务参数

参数名称参数类型是否必须示例值参数描述
appKeyString2w42E9JBF8hBSg3m4MmzqQ应用创建完成后被分配的 key
refreshTokenString2w42E9JBF8hBSg3m4MmzqQ用于刷新 access_token 的刷新令牌;有效期 7 天

响应参数

参数名称参数类型是否必须示例值参数描述
successBooleanTRUE表示操作是否成功
messageString操作成功!操作的结果提示信息
codeInteger200返回码,通常 200 表示成功
resultObject{ "accessToken": "...", "refreshToken": "..." }包含访问令牌和刷新令牌的结果对象
result.accessTokenStringeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...新的访问令牌
timestampInteger1741780916923响应生成的时间戳,单位为毫秒

在线调试

API 调试工具GET/POST
接口地址
POST
AppKey
Secret
业务参数

响应示例

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
}