分页获取单个用户的群聊列表信息
请求方法
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
},
.....
]
}