Get Joined Groups
Brief Description
- Retrieves the groups that a specified user has joined.
Request Method
post
Request URL
{API_ADDRESS}/group/get_joined_group_list
Header
Header Name | Example Value | Optional | Type | Description |
---|---|---|---|---|
operationID | 1646445464564 | Required | string | Used for global trace tracking. It is recommended to use a timestamp, unique for each request |
token | eyJhbxxxx3Xs | Required | string | Admin token |
Request Parameters Example
{
"fromUserID": "9906953281",
"pagination": {
"showNumber": 10,
"pageNumber": 1
}
}
Field Name | Optional | Type | Description |
---|---|---|---|
fromUserID | Required | string | User ID |
pagination | Required | object | Pagination parameter structure |
pagination.showNumber | Required | int | Number of items per page |
pagination.pageNumber | Required | int | Current page number, starting from 1 |
Success Response Example
{
"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": ""
}
]
}
}
Success Response Parameters Description
Parameter Name | Type | Description |
---|---|---|
errCode | int | Error code, 0 indicates success |
errMsg | string | Brief error message, empty if none |
errDlt | errDlt | Detailed error information, empty if none |
data | object | General data object, see structure below |
total | int | Total number of joined groups |
groups | array | List of Group Information |
Failure Response Example
{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}
Failure Response Parameters Description
Parameter Name | Type | Description |
---|---|---|
errCode | int | Error code, refer to global error code documentation |
errMsg | string | Brief error message |
errDlt | errDlt | Detailed error information |