获取已加入群组
简要描述
- 获取指定用户已加入的群组。
请求方式
post
请求URL
{API_ADDRESS}/group/get_joined_group_list
Header
header名 | 示例值 | 选填 | 类型 | 说明 |
---|---|---|---|---|
operationID | 1646445464564 | 必填 | string | 用于全局链路追踪,建议使用时间戳,在每个请求中独立 |
token | eyJhbxxxx3Xs | 必填 | string | 管理员 token |
请求参数示例
{
"fromUserID": "9906953281",
"pagination": {
"showNumber": 10,
"pageNumber": 1
}
}
字段名 | 选填 | 类型 | 说明 |
---|---|---|---|
fromUserID | 必填 | string | 用户ID |
pagination | 必填 | object | 分页参数结构体 |
pagination.showNumber | 必填 | int | 当前页码,从1开始 |
pagination.pageNumber | 必填 | int | 当前页请求数量 |
成功返回示例
{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"total": 3,
"groups": [
{
"groupID": "2137448827",
"groupName": "11111",
"notification": "",
"introduction": "",
"faceURL": "",
"ownerUserID": "3517105008",
"createTime": 1687753739612,
"memberCount": 3,
"ex": "",
"status": 0,
"creatorUserID": "2699373280",
"groupType": 2,
"needVerification": 0,
"lookMemberInfo": 0,
"applyMemberFriend": 0,
"notificationUpdateTime": 0,
"notificationUserID": ""
},
{
"groupID": "2759960147",
"groupName": "Group2",
"notification": "",
"introduction": "",
"faceURL": "",
"ownerUserID": "4771680259",
"createTime": 1688106933734,
"memberCount": 7,
"ex": "",
"status": 0,
"creatorUserID": "4771680259",
"groupType": 2,
"needVerification": 0,
"lookMemberInfo": 0,
"applyMemberFriend": 0,
"notificationUpdateTime": 0,
"notificationUserID": ""
},
{
"groupID": "3686066424",
"groupName": "Group3",
"notification": "",
"introduction": "",
"faceURL": "",
"ownerUserID": "9906953281",
"createTime": 1687933342067,
"memberCount": 3,
"ex": "",
"status": 0,
"creatorUserID": "9906953281",
"groupType": 2,
"needVerification": 0,
"lookMemberInfo": 0,
"applyMemberFriend": 0,
"notificationUpdateTime": 0,
"notificationUserID": ""
}
]
}
}
成功返回示例的参数说明
参数名 | 类型 | 说明 |
---|---|---|
errCode | int | 错误码,0表示成功 |
errMsg | string | 错误简要信息,为空 |
errDlt | errDlt | 错误详细信息,为空 |
data | object | 通用数据对象,具体结构见下方 |
total | int | 加入的群总数 |
groups | array | 群信息列表 |
失败返回示例
{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}
失败返回示例的参数说明
参数名 | 类型 | 说明 |
---|---|---|
errCode | int | 错误码,具体查看全局错误码文档 |
errMsg | string | 错误简要信息 |
errDlt | errDlt | 错误详细信息 |