Skip to main content

Get Joined Groups

Brief Description

  • Get groups joined by designated user.

Request Method

  • post

Request URL

  • {API_ADDRESS}/group/get_joined_group_list
Header NameExample ValueOptionalTypeDescription
operationID1646445464564RequiredstringUsed for global link tracking, timestamp is recommended, independent in each request
tokeneyJhbxxxx3XsRequiredstringAdmin token

Request Parameter Example

{
"fromUserID": "9906953281",
"pagination": {
"showNumber": 10,
"pageNumber": 1
}
}
Field NameOptionalTypeDescription
fromUserIDRequiredstringUser ID
paginationRequiredobjectPagination parameter structure
pagination.showNumberRequiredintCurrent page number, starting from 1
pagination.pageNumberRequiredintNumber of requests on the current page

Success Return 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": ""
}
]
}
}

Parameter Description for Success Return Example

Parameter NameTypeDescription
errCodeintError code, 0 means successful
errMsgstringBrief error message, empty
errDlterrDltDetailed error message, empty
dataobjectGeneric data object, specific structure is below
totalintTotal number of joined groups
groupsarrayGroup info list

Failure Return Example

{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}

Parameter Description for Failure Return Example

Parameter NameTypeDescription
errCodeintError code, specifically check the global error code document
errMsgstringBrief error message
errDlterrDltDetailed error message