当一些业务场景下,需要保持用户一直在登录状态。例如用户在调用试题列表接口时,登录token还没有失效,但是在答题过程中,token失效了,用户提交答题时就会验证用户登录状态,token失效会让用户登录,在交互上有点繁琐,而且增加了系统的复杂度,因此调用刷新token接口,可以保持token在这些场景下永远处于有效期。在刷新成功后,会返回新的token,前端需要及时的替换本地旧token。
刷新接口
请求方法:POST
是否鉴权:是
请求编码:Content-Type:application/x-www-form-urlencoded
响应编码:Content-Type:application/json;charset=UTF-8
请求地址:index/csrf/referUserToken
请求参数:
参数名 | 参数类型 | 是否必填 | 参数说明 | 示例值 |
---|
- 成功示例:
javascript
{
"data": {
"refer_token": "d891b9b3c4a16e454fd7310bfef4391b",
},
"code": 100,
"msg": "请求成功"
}
参数名 | 参数类型 | 是否必有 | 参数说明 | 示例值 |
---|---|---|---|---|
refer_token | string | 是 | 新token | 见上述示例 |
- 失败示例:
javascript
{
"code": 101,
"data": [],
"msg": "刷新失败"
}