# 查询用户归属群列表

请求方式: 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 总行数