查询 APP 下的群组列表
URL
https://sdk.cloudroom.com/im/v1/group/app/list
请求方式:POST
请求参数
接口参数
| 名称 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
| PageNumber | Integer | 否 | 页码,默认 1 |
| PageSize | Integer | 否 | 每页数量 ,默认 20,最大 100 |
返回参数
| 名称 | 类型 | 说明 |
|---|---|---|
| RspCode | Int | 响应码 |
| RspDesc | String | 响应描述 |
| Data | Object | 数据对象 |
| Data.Total | Int | 总数 |
| Data.Groups | String[] | 群组列表 |
Groups 数据详情
| 名称 | 类型 | 说明 |
|---|---|---|
| GroupID | String | 群ID |
| GroupName | String | 群名称 |
| FaceURL | String | 群头像地址 |
| MemberCount | Int | 当前群组成员数量 |
| CreateTime | Long | 群组创建时间戳 |
示例
请求示例
curl -X POST https://sdk.cloudroom.com/im/v1/group/list \
-H "Content-Type: application/json" \
-d '{
"RequestId": "2d95a5fe-a384-5dea-0d84-db153b10ee0f",
"CompID": "1111111",
"SecretKey": "b7febff6a21c36fb50150f88c95ef641",
"PageNumber": 1,
"PageSize": 20,
}'
返回示例
{
"RspCode": 0,
"RspDesc": "请求成功",
"Data": {
"Total": 1,
"Groups": [
{
"GroupID": "2355472856",
"GroupName": "客服群",
"MemberCount": 15,
"FaceURL": "",
"CreateTime": 1706860800000,
}
]
}
}
状态码
上述接口在 HTTPS Body 中返回请求的状态码,状态码详情请参见 状态码