刷新云端资源Token
更新时间:2025-03-26 10:44:56
调用该接口刷新云端资源的Token。原始的cloudToken(accessToken)保留1min有效期,原始的refreshToken立即失效。
描述 | 值 |
---|---|
路径 | /platform/cloud/token/refresh |
版本号 | 1.0.0 |
协议 | HTTPS |
请求方法 | POST |
请求参数:
公共请求参数见 公共请求参数
请求字段 | 类型 | 必选 | 描述 |
---|---|---|---|
refreshToken | String | 是 | 刷新令牌 |
返回参数:
返回字段 | 类型 | 描述 |
---|---|---|
id | String | 用于识别请求记录,即对应的请求ID。 |
code | Int | 接口返回码字段,请求成功时返回200;请求失败时返回详细的错误码。 |
message | String | 调用失败时,返回的出错信息 |
data | Object | 响应的结果。 |
accessToken | String | 访问令牌,即云端API公共请求参数中cloudToken。 |
refreshToken | String | 刷新令牌,在访问令牌过期后,可以用来获取新的访问令牌以及刷新令牌。 |
expireTime | Int | accessToken有效时间,单位秒 |
请求示例:
x-ca-key: xxxxxxxx
x-ca-timestamp: 1728634151000
x-ca-nonce: 7b25fc15b9434dd98587a077a92b7e42
x-ca-signature: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
Content-Type: application/json;charset=UTF-8
{
"id": "49a7be92******facf7",
"version": "1.0",
"request": {
"apiVer": "1.0.0"
},
"params": {
"refreshToken": "eyJhbGciO******SBuLUqCjm8qXRM5Z3f663tOEMZmjKX3gULY4"
}
}
成功返回示例:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
{
"id": "49a7be9******ba0facf7",
"code": 200,
"data": {
"expireTime": 7200,
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI******82l7TYGFogLvWBaNSm0lkvXp1MQ3AM1o_j40c",
"refreshToken": "eyJhbGciOiJIUzI1NiIsInR5******96bYVO9FiPVVegXzXCDVIa7N8gJclisHuG-I"
}
}