跳转到主要内容
POST
/
user
/
token
curl -X POST "http://localhost:5001/user/token" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "user123",
    "token": "new_auth_token_here",
    "device_flag": 1,
    "device_level": 1
  }'
{
  "status": "ok"
}

概述

更新用户的认证令牌,用于用户重新登录或令牌刷新场景。

请求体

必传参数

uid
string
required
通信的用户唯一ID,可以随机uuid (建议自己服务端的用户唯一uid) (WuKongIMSDK需要)
token
string
required
校验的token,随机uuid(建议使用自己服务端的用户的token)(WuKongIMSDK需要)
device_flag
integer
required
设备标识 0.app 1.web 2. desktop (相同用户相同设备标记的主设备登录会互相踢,从设备将共存)

可选参数

device_level
integer
设备等级 0.为从设备 1.为主设备
curl -X POST "http://localhost:5001/user/token" \
  -H "Content-Type: application/json" \
  -d '{
    "uid": "user123",
    "token": "new_auth_token_here",
    "device_flag": 1,
    "device_level": 1
  }'
{
  "status": "ok"
}

响应字段

status
string
required
操作状态,成功时返回 "ok"

状态码

状态码说明
200Token 更新成功
400请求参数错误
500服务器内部错误

最佳实践

  1. Token 安全:确保 Token 具有足够的复杂度和唯一性
  2. 设备标识:合理设置 device_flag 以区分不同设备类型
  3. 权限控制:通过 device_level 实现不同设备的权限控制
  4. 定期刷新:实施 Token 定期刷新机制
  5. 多设备管理:为不同设备生成不同的 Token,便于管理和撤销