Skip to main content

Get Group Join Requests by User ID

Brief Description

  • Retrieves the join requests of specified users for a specific group.

Request Method

  • post

Request URL

  • {API_ADDRESS}/group/get_group_users_req_application_list
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": "234",
"userIDs": [
"123"
]
}
Field NameOptionalTypeDescription
groupIDRequiredstringGroup ID
userIDsRequiredarrayList of user IDs

Success Response Example

{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"total": 1,
"groupRequests": [
{
"userInfo": {
"userID": "1225441072",
"nickname": "blooming66",
"faceURL": "",
"ex": ""
},
"groupInfo": {
"groupID": "3666081223",
"groupName": "group1",
"notification": "notification1",
"introduction": "",
"faceURL": "",
"ownerUserID": "1054527962",
"createTime": 1687747185342,
"memberCount": 14,
"ex": "",
"status": 0,
"creatorUserID": "1054527962",
"groupType": 2,
"needVerification": 0,
"lookMemberInfo": 0,
"applyMemberFriend": 0,
"notificationUpdateTime": 0,
"notificationUserID": ""
},
"handleResult": 1,
"reqMsg": "hello",
"handleMsg": "reason",
"reqTime": 1687747407352,
"handleUserID": "",
"handleTime": 0,
"ex": "",
"joinSource": 3,
"inviterUserID": ""
}
]
}
}

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
totalintTotal number of group join requests
groupRequestsarrayList of Group Join Request Objects

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