群动作
get_group_info
获取群信息
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
group_name |
string | - | 群名称 |
{
"action": "get_group_info",
"params": {
"group_id": "123456"
}
}
{
"status": "ok",
"retcode": 0,
"data": {
"group_id": "123456",
"group_name": "一群大笨蛋"
},
"message": ""
}
get_group_list
获取群列表
获取机器人加入的群列表。
无。
群信息列表,每一个元素的字段同 get_group_info
的响应数据。
{
"action": "get_group_list",
"params": {}
}
{
"status": "ok",
"retcode": 0,
"data": [
{
"group_id": "123456",
"group_name": "一群大笨蛋"
},
{
"group_id": "654321",
"group_name": "一群大笨蛋2群"
}
],
"message": ""
}
get_group_member_info
获取群成员信息
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
user_id |
string | - | 用户 ID |
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
user_id |
string | - | 用户 ID |
nickname |
string | - | 用户名称/昵称 |
{
"action": "get_group_member_info",
"params": {
"group_id": "123456",
"user_id": "3847573"
}
}
{
"status": "ok",
"retcode": 0,
"data": {
"user_id": "3847573",
"nickname": "我是大笨蛋"
},
"message": ""
}
get_group_member_list
获取群成员列表
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
群成员信息列表,每一个元素的字段同 get_group_member_info
的响应数据。
{
"action": "get_group_member_list",
"params": {
"group_id": "123456"
}
}
{
"status": "ok",
"retcode": 0,
"data": [
{
"user_id": "111222333",
"nickname": "我是大笨蛋"
},
{
"user_id": "444555666",
"nickname": "我是小笨蛋"
}
],
"message": ""
}
set_group_name
设置群名称
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
group_name |
string | - | 新群名称 |
无。
{
"action": "set_group_name",
"params": {
"group_id": "2452352435",
"group_name": "一个非常普通的群名"
}
}
{
"status": "ok",
"retcode": 0,
"data": null,
"message": ""
}
leave_group
退出群
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
无。
{
"action": "leave_group",
"params": {
"group_id": "2452352435"
}
}
{
"status": "ok",
"retcode": 0,
"data": null,
"message": ""
}
kick_group_member
踢出群成员
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
user_id |
string | - | 用户 ID |
无。
{
"action": "kick_group_member",
"params": {
"group_id": "123456",
"user_id": "123456789"
}
}
{
"status": "ok",
"retcode": 0,
"data": null,
"message": ""
}
ban_group_member
禁言群成员
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
user_id |
string | - | 用户 ID |
无。
{
"action": "ban_group_member",
"params": {
"group_id": "123456",
"user_id": "123456789"
}
}
{
"status": "ok",
"retcode": 0,
"data": null,
"message": ""
}
unban_group_member
取消禁言群成员
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
user_id |
string | - | 用户 ID |
无。
{
"action": "unban_group_member",
"params": {
"group_id": "123456",
"user_id": "123456789"
}
}
{
"status": "ok",
"retcode": 0,
"data": null,
"message": ""
}
set_group_admin
设置群管理员
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
user_id |
string | - | 用户 ID |
无。
{
"action": "set_group_admin",
"params": {
"group_id": "123456",
"user_id": "123456789"
}
}
{
"status": "ok",
"retcode": 0,
"data": null,
"message": ""
}
unset_group_admin
取消设置群管理员
字段名 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
group_id |
string | - | 群 ID |
user_id |
string | - | 用户 ID |
无。
{
"action": "unset_group_admin",
"params": {
"group_id": "123456",
"user_id": "123456789"
}
}
{
"status": "ok",
"retcode": 0,
"data": null,
"message": ""
}