mirror of
https://github.com/WuKongIM/WuKongIMDocs
synced 2025-06-05 00:28:01 +00:00
109 lines
1.8 KiB
Markdown
109 lines
1.8 KiB
Markdown
---
|
|
title: 用户
|
|
order: 1
|
|
---
|
|
|
|
# 用户
|
|
|
|
## 注册或登录
|
|
|
|
将用户信息注册到狸猫 IM 通讯端，如果存在则更新
|
|
|
|
> POST /user/token
|
|
|
|
请求参数:
|
|
|
|
```json
|
|
{
|
|
"uid": "xxxx", // 第三方服务端的用户唯一uid
|
|
"token": "xxxxx", // 第三方服务端的用户的token
|
|
"device_flag": 0, // 设备标识 0.app 1.web （相同用户相同设备标记的主设备登录会互相踢，从设备将共存）
|
|
"device_level": 1 // 设备等级 0.为从设备 1.为主设备
|
|
}
|
|
```
|
|
|
|
成功响应
|
|
|
|
```
|
|
http status为200
|
|
```
|
|
|
|
## 用户在线状态
|
|
|
|
查询一批用户的在线状态。
|
|
|
|
> POST /user/onlinestatus
|
|
|
|
请求参数:
|
|
|
|
```json
|
|
[uid123,uid345,uid456...] // 需要查询在线状态的用户uid列表
|
|
|
|
```
|
|
|
|
成功响应
|
|
|
|
```json
|
|
[uid123,uid456...] // 返回在线的用户uid集合
|
|
```
|
|
|
|
## 添加系统账号
|
|
|
|
系统账号将有发送消息的全部权限，不受黑名单限制，无需在订阅列表里，比如“系统通知”，“客服”等这种类似账号可以设置系统账号
|
|
|
|
> POST /user/systemuids_add
|
|
|
|
请求参数:
|
|
|
|
```json
|
|
{
|
|
"uids": [uid123,uid345,uid456...] // 需要加入系统账号的用户uid集合列表
|
|
}
|
|
|
|
```
|
|
|
|
成功响应
|
|
|
|
```
|
|
http status 200
|
|
```
|
|
|
|
## 移除系统账号
|
|
|
|
将系统账号移除
|
|
|
|
> POST /user/systemuids_remove
|
|
|
|
请求参数:
|
|
|
|
```json
|
|
{
|
|
"uids": [uid123,uid345,uid456...] // 系统账号的用户uid集合列表
|
|
}
|
|
```
|
|
|
|
成功响应
|
|
|
|
```
|
|
http status 200
|
|
```
|
|
|
|
## 踢出用户的设备登录
|
|
|
|
将用户的设备踢出登录，（可以实现类似微信的 app 可以踢出 pc 登录）
|
|
|
|
请求参数:
|
|
|
|
```json
|
|
{
|
|
"uid": "xxxx", // 需要踢出的用户uid
|
|
"device_flag": 1 // 需要踢出的设备标记 -1: 当前用户下所有设备 0. 当前用户下的app 1. 当前用户下的web 2. 当前用户下的pc
|
|
}
|
|
```
|
|
|
|
成功响应
|
|
|
|
```
|
|
http status 200
|
|
```
|