## 创建群组
+++
get:/group/create
*group_name=组名，群组名称#
*user_name=群主用户名#群主用户名
json:members={"key":"value","key_2":"value_2"...}#群组成员用户
<<<
success
{
"data": [
{
"user_id": 组员用户id,
"group_id": 群组id,
"id": group_user_id
},
{
"user_id": 组员用户id,
"is_admin": 0-普通组员,1-群主;2-管理员,
"group_id": 群组id,
"id": group_user_id
}
],
"msg": "创建群组成功！",
"code": 1
}
<<<
error
{
"data": {},
"msg": "创建群组失败！",
"code": 0
}
+++
## 解散群组
+++
get:/group/disband
*group_id=群组id#
*user_name=群主用户名#群主用户名
<<<
success
{
"data": true,
"msg": "群组解散成功！",
"code": 1
}
<<<
error
{
"data": {},
"msg": "群组解散失败！",
"code": 0
}
+++
### 退出群组
~~~[api]
get:/group/quit
*exit_user_name=用户名称#操作退群的用户
*int:group_id=群组id#用户所在群组的id
<<<
success
{
"data": true,
"msg": "成功退出群组！",
"code": 1
}
<<<
error
{
"data": {},
"msg": "退出群组失败！",
"code": 0
}
~~~
## 修改群组资料
+++
get:/group/update
*int:group_id=群组id，群组名称#群组id
*user_name=群主用户名#群主用户名
*group_name=群组名称#群组名称
<<<
success
{
"data": 1,
"msg": "更新成功！",
"code": 1
}
<<<
error
{
"data": {},
"msg": "更新失败！",
"code": 0
}
+++
## 搜索群组
+++
get:/group/search
*keyword=模糊搜索群组名称#群组名称
<<<
success
{
"data": [
{
"id": 群组id,
"user_id": 群主的用户id,
"name": 群组名称
"avator": 群组头像,
"is_group": 群组类型,
"created": time(),
"updated": time(),
"group_user": {
"id": group_user_id,
"group_id": 群组id,
"user_id": 用户id,
"is_admin": 是否是管理员
}
},
{....}
],
"msg": "搜索成功!",
"code": 1
}
<<<
error
{
"data": {},
"msg": "暂无符合要求的数据！",
"code": 0
}
+++
## 拉人入群
+++
get:/group/addInto
*int:group_id=群组id#群组id
*json:members=被拉用户数组# 用户名称
<<<
success
{
"data": [
{
"user_id":用户id,
"group_id": 群组id,
"id": group_user_id
},
{....}
],
"msg": "操作成功！",
"code": 1
}
<<<
error
{
"data": {},
"msg": "操作失败！",
"code": 0
}
+++
## 踢人出群
+++
get:/group/kickFrom
*int:group_id=群组id#群组id
*user_name=群主名称#群主用户名
*del_user_name=被移除人的用户名 #被踢出者用户名
<<<
success
{
"data": 1,
"msg": "移除成功！",
"code": 1
}
<<<
error
{
"data": {},
"msg": "移除失败！",
"code": 0
}
+++
## 移交群主
+++
get:/group/changeOwner
*int:group_id=群组id#群组id
*user_name=群主用户名#群主用户名
*new_user_name=新群主用户名#新群主用户名
<<<
success
{
"data": true,
"msg": "移交成功！",
"code": 1
}
<<<
error
{
"data": {},
"msg": "移交失败！",
"code": 0
}
+++
## 任命管理员
+++
get:/group/addManger
*int:group_id=群组id#群组id
*user_name=群主用户名#群主用户名
*new_user_name=新管理员用户名#新管理员用户名
<<<
success
{
"data": 1,
"msg": "任命成功！",
"code": 1
}
<<<
error
{
"data": {},
"msg": "任命失败！",
"code": 0
}
+++
## 移除管理员
+++
get:/group/removeManger
*int:group_id=群组id#群组id
*user_name=群主用户名#群主用户名
*remove_user_name=将要移除的管理员用户名#旧管理员用户名
<<<
success
{
"data": 1,
"msg": "移除成功！",
"code": 1
}
<<<
error
{
"data": {},
"msg": "移除失败！",
"code": 0
}
+++
## 获取用户加入的群信息
+++
get:/group/joined
*user_name=用户名#用户名
<<<
success
{
"data": [
{
"id": 群组id,
"user_id": 用户id,
"name": 群组信息,
"avator": 群组头像id,
"is_group": 群组类型,
"created": time(),
"updated": time()
}
],
"msg": "查询成功",
"code": 1
}
<<<
error
{
"data": {},
"msg": "查询失败",
"code": 0
}
+++
## 获取群成员用户信息
~~~[api]
get:/group/members
*int:group_id=群组id#群组id
<<<
success
{
"data": [
{
"id": profile_id,
"user_id": 用户id,
"nickname": "昵称",
"avator": 头像id,
"created": time(),
"updated": time(),
"sign": "个性签名"
},
...
],
"msg": "查询成功",
"code": 1
}
<<<
error
{
"data": {},
"msg": "查询失败！",
"code": 0
}
~~~
