分页获取单个用户的群聊列表信息
更新时间:2026-10-28 13:48:48

分页获取单个用户的群聊列表信息

请求方法

GET

请求地址

/sessions/{userId}/session-infos

请求参数

参数 参数类型 数据类型 是否必需 描述
userId Path string 是 用户ID
version query long 否 版本号(返回对象的version值),默认0XFFFF
limit query int 否 每批的数量,默认200

HTTP状态码

返回值 描述
200 操作成功,详见响应参数
400 客户端传参异常
401 鉴权失败
500 服务端异常

响应参数

参数 数据类型 描述
version long 版本号
sessionInfos List<Input> 会话成员信息列表

Input 对象

参数 数据类型 描述
sessionId long 群ID
sessionName String 群名称
iconUrl String 群头像URL

请求消息示例

GET /open/api/v2/sessions/{userId}/session-infos?version=213213214 HTTP/1.1
Host: api.yealink.com
Content-Type: application/json

响应消息示例

HTTP/1.1 200 
Content-Type: application/json;charset=UTF-8

{
”version“:213213214,
"sessionInfos":[{
              "sessionId":213123123123,  // 群ID
              "sessionName":"群A", // 群名称
              "iconUrl":"https://10.122.131.14/ydfs/api/v1/files/public/ade9e663d98d4245895d0faadcc84777.jpg?ydfs-file-name=cat.jpg", //群头像URL
           },
            {
              "sessionId":213123123123, // 群ID
              "sessionName": "群B" //群名称
              "iconUrl":"https://10.122.131.14/ydfs/api/v1/files/public/ade9e663d98d4245895d0faadcc84777.jpg?ydfs-file-name=cat.jpg", //群头像URL
              }, 
.....
]
}
本页目录