setUidSession
设置某个UID对应的Session,即:UID会话Session
- 此方法需要配合 bindUid 使用
- 此处设置的Session是以UID纬度独立存储,与 setSession 并不互通
- uid与client_id是一对多的关系,允许多个client_id绑定一个uid
- 如果某uid绑定的client_id只要有一个在线,所设置的
UID会话Session
存续 - 如果某uid绑定的client_id全部离线,则
UID会话Session
会自动销毁
接口URL
/api/setUidSession
请求方式
POST
Content-Type
application/json;charset=utf-8
请求Header参数
普通模式(Token验证)
默认,服务运行于普通模式,请求携带Header参数:
参数名 | 类型 | 描述 |
---|---|---|
Token | string | 认证Token,即 config.json 文件中的Token |
安全模式(签名验证)
可指定启动参数 -s=true
,将服务运行于安全模式,请求携带Header参数:
参数名 | 类型 | 描述 |
---|---|---|
Timestamp | int | 请求毫秒时间戳 |
Signature | string | 请求签名值签名算法 |
请求Query参数
参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
---|---|---|---|---|
uid | 1 | string | 是 | - |
请求Body参数
任意Json对象字符串,键值对会保存在UID的Session中
json
{
"key": "value"
}
响应示例
成功
json
{
"code": 0,
"message": "成功"
}
失败
json
{
"code": 118,
"message": "UID不在线或不存在"
}