Skip to content

setUidSession

设置某个UID对应的Session,即:UID会话Session

  1. 此方法需要配合 bindUid 使用
  2. 此处设置的Session是以UID纬度独立存储,与 setSession 并不互通
  3. uid与client_id是一对多的关系,允许多个client_id绑定一个uid
  4. 如果某uid绑定的client_id只要有一个在线,所设置的 UID会话Session 存续
  5. 如果某uid绑定的client_id全部离线,则 UID会话Session 会自动销毁

接口URL

/api/setUidSession

请求方式

POST

Content-Type

application/json;charset=utf-8

普通模式(Token验证)

默认,服务运行于普通模式,请求携带Header参数:

参数名类型描述
Tokenstring认证Token,即 config.json 文件中的Token

安全模式(签名验证)

可指定启动参数 -s=true,将服务运行于安全模式,请求携带Header参数:

参数名类型描述
Timestampint请求毫秒时间戳
Signaturestring请求签名值签名算法

请求Query参数

参数名示例值参数类型是否必填参数描述
uid1string-

请求Body参数

任意Json对象字符串,键值对会保存在UID的Session中

json
{
  "key": "value"
}

响应示例

成功

json
{
  "code": 0,
  "message": "成功"
}

失败

json
{
  "code": 118,
  "message": "UID不在线或不存在"
}