Skip to main content

Get Specific Group Members

Brief Description

  • Retrieves detailed information for specified members of a group.

Request Method

  • post

Request URL

  • {API_ADDRESS}/group/get_group_members_info
Header NameExample ValueOptionalTypeDescription
operationID1646445464564RequiredstringUsed for global trace tracking. It is recommended to use a timestamp, unique for each request
tokeneyJhbxxxx3XsRequiredstringAdmin token

Request Parameters Example

{
"groupID": "324253771",
"userIDs": ["7009965934"]
}
Field NameOptionalTypeDescription
groupIDRequiredstringGroup ID
userIDsRequiredarrayList of group member IDs

Success Response Example

{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"members": [
{
"groupID": "xadxwr24",
"userID": "199975690",
"roleLevel": 2,
"joinTime": 1679656402380,
"nickname": "Jason",
"faceURL": "ic_avatar_05",
"appMangerLevel": 0,
"joinSource": 2,
"operatorUserID": "openIMAdmin",
"ex": "",
"muteEndTime": 0,
"inviterUserID": "openIMAdmin"
},
{
"groupID": "xadxwr24",
"userID": "1910095287",
"roleLevel": 1,
"joinTime": 1679656402380,
"nickname": "2234",
"faceURL": "",
"appMangerLevel": 0,
"joinSource": 2,
"operatorUserID": "openIMAdmin",
"ex": "",
"muteEndTime": 0,
"inviterUserID": "openIMAdmin"
}
]
}
}

Success Response Parameters Description

Parameter NameTypeDescription
errCodeintError code, 0 indicates success
errMsgstringBrief error message, empty if none
errDlterrDltDetailed error information, empty if none
dataobjectGeneral data object, see structure below
membersarrayList of Group Member Information

Failure Response Example

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

Failure Response Parameters Description

Parameter NameTypeDescription
errCodeintError code, refer to global error code documentation
errMsgstringBrief error message
errDlterrDltDetailed error information