刷新 Token
更新时间: 2024/11/04 15:22:15
通过该接口刷新 Token。
使用场景:为了更好的保障账号的安全,您可以定期刷新 Token。当 Token 不慎泄漏时,您需要调用该接口立即刷新 Token。
接口请求地址
- 请求方法:POST
- URL:https://roomkit.netease.im/apps/v1/refreshToken
- Content-Type:application/json
请求参数
- POST 请求中 Header 的设置请参考调用方式中的请求结构描述。
- POST 请求中 Body 的设置如下:
参数名称 | 类型 | 是否必选 | 示例 | 描述 |
---|---|---|---|---|
userUuid | String | 必选 | user01 | 用户账号,必须保证唯一性。 由小写英文、数字、下划线(_)、@、英文句号(.)和短横线(-)组成,最大32个字符。 |
deviceId | String | 可选 | 7fc26ed***e6b724765 | 终端设备ID,用户自定义。 由英文、数字、下划线(_)和短横线(-)组成,最大长度64个字符。 |
返回结果
参数名称 | 类型 | 示例 | 描述 |
---|---|---|---|
code | int | 0 | 状态码,0表示成功,具体请参见错误码。 |
msg | String | Success | 业务结果描述,Success表示成功。 |
ts | Long | 1648021056815 | NERoom 服务器处理该请求的完成时间。 该时间为 Unix 时间戳,即从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的毫秒数。 |
requestId | String | 7c4b6d9c3e9d42*****cc6e3a4d995 | 请求的唯一标识。 |
cost | String | 48ms | 处理该请求所消耗的时间。 |
data | Object | - | token的结果。 |
data.accessToken | String | 0ZNLD4***251D1 | 获取Token的参数返回结果。 |
示例
请求示例
java{
"userUuid":"test1",
"deviceId":"7fc26ed***e6b724765"
}
返回示例
java{
"code": 0,
"msg": "Success",
"ts": 1648038869677,
"cost": "16ms",
"requestId": "7c23f617319***515551b8296eed1",
"data": {
"accessToken": "0ZNLD4***2N251D1"
}
}
此文档是否对你有帮助?