# 查询用户归属群列表
请求方式: GET
请求地址: https://nbd-api.myscrm.cn/bff-nbd-qw-openapi/v1/groupchat/list-by-user
请求参数说明:
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
app_id | string | 是 | 企微中台应用 ID |
userid | string | 是 | 群成员企微id |
role | int32 | 否 | 群成员角色:0-全部,1-普通群员,2-群管理员,3-群主 |
pager.page | int64 | 否 | 页码 |
pager.page_size | int64 | 否 | 分页行数 |
请求参数示例:
https://nbd-api.myscrm.cn/bff-nbd-qw-openapi/v1/groupchat/list-by-user?app_id=xxx&userid=xxx&role=0&pager.page=1&pager.page_size=10
返回数据:
{
"errcode": 0,
"errmsg": "ok",
"list": [
{
"chat_id": "string",
"name": "string",
"e_id": "string",
"status": 0,
"qw_create_time": "string",
"modify_at": "string",
"notice":"string",
"owner": {
"userid": "string",
"name": "string",
"group_nickname": "string",
"avatar": "string"
},
"qw_chat_id": "string"
}
],
"pager": {
"page": "1",
"page_size": "10",
"total_rows": "100"
}
}
返回参数说明:
参数 | 类型 | 说明 |
---|---|---|
list.chat_id | string | 中台客户群id |
list.name | string | 群名 |
list.e_id | string | 企业id |
list.status | int32 | 群状态:1-离职待继承,2-离职继承中,3-离职继承完成,4-正常,5-群已解散 |
list.qw_create_time | string | 客户群创建时间:yyyy-mm-dd hh:ii:ss |
list.modify_at | string | 最近更新时间: yyyy-mm-dd hh:ii:ss |
list.notice | string | 群公告 |
list.owner.userid | string | 群主id |
list.owner.name | string | 群主名称 |
list.owner.group_nickname | string | 群主在群昵称 |
list.owner.avatar | string | 群成员头像 |
list.qw_chat_id | string | 企微群id |
pager | object | 分页信息 |
pager.page | string | 页码 |
pager.page_size | string | 分页行数 |
pager.page_size | string | 总行数 |