文档
测试

取得群成员

POST
[host]/OAapp/v1/open-api/group/kick-members

接口描述

取得群成员

前置处理

1.用户调用此功能前需取得access_token。 参照:[获取应用访问令牌](doc:k2xwfXh9),设置该方法返回值至接口【**Heard**】。 2.用户调用此功能前需取得group_id。 参照:[创建群](doc:zpq5AIVi)的返回值 3.用户调用此功能前需取得owner。 参照:[创建群](doc:zpq5AIVi)的时设置的用户ID集合中的第一人。

请求头

参数名
类型
描述
必填
Content-Type
string
值必须为:application/json;charset=UTF-8
必填
access_token
string
访问令牌
必填

请求参数

参数名
类型
描述
必填
owner
string
群主id
必填
group_id
string
群ID
必填
condition
string
搜索条件 成员名中文,拼音,模糊检索
可选
page_num
int
页号
必填
page_size
int
每页数据数量
必填

响应参数

参数名
类型
描述
必填
code
int
200000 : 正常 以外:异常
必填
message
string
异常内容
必填
data
string
群成员信息
可选
uuid
string
用户id
必填
name
string
用户名
必填
groupPosition
int
成员角色:100 群主 99 群管理员 0或null 群成员
必填

说明 / 示例

**请求示例** ```language host/OAapp/v1/open-api/group/kick-members header Content-Type:application/json;charset=UTF-8 access_token:ZC9weWJSK0NZWjZIZHlYTzJuWWplL0xFcTllOWE0Z1VVS3Mrb1RmOXpnQnd6U2QzQzZqQkg0L3Y4T0o5SkNqczRTRVdBV0luVDFXakVoVmdFSlFZZ1E9PQ== body: { "owner":"cs01", "group_id":"00cdc7ca0953b142f0546811817de3eg", "condition":"cs", "page_num":1, "page_size":20 } ``` **响应示例** ```language { "code": 200000, "msg": "response_success", "data": { [ { "uuid": "cs01", "name": "cs01", "groupPosition": 100 }, { "uuid": "cs02", "name": "cs02", "groupPosition": null } } } ```