刷新 Token
Token 具有时效性，本章主要介绍如何调用接口刷新 Token。
请求信息
基本信息
| 名称 | 取值 |
|---|
| 请求地址 | https://open.edgeros.com/openapi/v1/auth/refresh-token |
| 请求方法 | PUT |
| 参数方式 | Body |
请求头
| 字段名 | 类型 | 是否必填 | 示例值 | 说明 |
|---|
| Content-Type | String | 是 | application/json;charset=utf-8 | 固定值：application/json;charset=utf-8 |
请求参数
| 字段名 | 类型 | 是否必填 | 校验规则 | 示例值 | 说明 |
|---|
| refreshToken | String | 是 | 不能为非空字符 | eyJhbGba**** | 刷新 Token，调用获取 Token 接口时返回，如何调用获取 Token 接口，请参见 获取 Token |
| clientId | String | 是 | 不能为非空字符 | evvaGSAd**** | 申请的客户端 ID，生成应用凭证时获得，如何生成应用凭证，请参见 生成应用凭证 |
| secret | String | 是 | 不能为非空字符 | YAcmfRBs**** | 应用密钥，生成应用凭证时获得，如何生成应用凭证，请参见 生成应用凭证 |
请求示例
{
"refreshToken": "eyJhbGba****",
"clientId": "evvaGSAd****",
"secret": "YAcmfRBs****"
}
响应信息
data 参数
| 字段名 | 类型 | 示例值 | 说明 |
|---|
| accessToken | String | eyJhbGci**** | 刷新后的 Token，使用该值可调用开放平台的其他接口 |
| refreshToken | String | eyJhbGba**** | 刷新 Token，使用该值可以调用刷新 Token 接口生成新的 Token |
| expire | Integer | 10799 | 新 Token 的剩余有效时间，单位为秒 |
响应示例
{
"status": 200,
"message": "success",
"fieldErrors": null,
"data": {
"accessToken": "eyJhbGci****",
"refreshToken": "eyJhbGba****",
"expire": 10799
}
}
响应错误码
| 错误码 | 含义 | 解决方案 |
|---|
| 21032 | 认证失败 | 检查请求参数是否符合要求 |
| 21033 | Token 无效 | 检查 Token 是否合法、是否过期 |
| 21034 | 应用凭证无效 | 检查应用凭证 ClientId 和 App Secret 是否正确 |
| 21035 | 刷新 Token 无效或已经使用 | 检查刷新 Token 是否错误或者已经使用 |
陕公网安备61019002002605号