# 获取指定成员的群聊列表
按最近聊天时间倒序返回。
# 请求方式
GET
# 请求地址
https://nbd-api.myscrm.cn/bff-nbd-qw-openapi/v1/group-chat/list-by-member
# 请求参数
# 示例
curl https://nbd-api.myscrm.cn/bff-nbd-qw-openapi/v1/group-chat/list-by-member?app_id=3a0b4504-9036-0b19-0dc8-6dd504894ab0
&member_id=woD2JCDwAA58CwGf1EkYVaLhiq5bE5xx
&member_type=1
&name=
&cursor=
# 说明
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
app_id | string | 是 | 企微中台应用 id |
member_id | string | 是 | 成员 id,member_type=1 时为企微员工 id,member_type=2 时为企微外部联系人 id |
member_type | int32 | 是 | 成员类型:1-企业成员;2-外部联系人 |
name | string | 否 | 群聊名称,模糊搜索 |
cursor | string | 否 | 分页游标,上一次请求返回的 next_cursor,第一页传空 |
# 返回参数
# 示例
{
"errcode": 0,
"errmsg": "ok",
"list": [
{
"chat_id": "e770bd17-4c84-4ebd-9768-d029273d763a",
"name": "群聊",
"created_at": "1691620231",
"last_chat_at": "1691720231623",
"avatar_url": "https://yunke-oss.oss-cn-hangzhou.aliyuncs.com/yued/qiwei/cms/icon_group_chat_default.png"
}
],
"next_cursor": ""
}
# 说明
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
list.chat_id | string | 是 | 企微中台聊天 id |
list.name | string | 是 | 群聊名称 |
list.created_at | string | 是 | 群聊创建的秒级时间戳 |
list.last_chat_at | string | 否 | 上一次聊天时间的毫秒时间戳 |
list.avatar_url | string | 否 | 群聊头像 |
next_cursor | string | 否 | 下一页游标,当记录数超过一定数量时返回,为空时表示已没有更多数据可获取 |