You can call this operation to batch unblock up to 20 users for a user. If you need a higher limit, contact ZEGOCLOUD technical support.
After users are unblocked, the client of the user receives the notification in the following ZIM SDK callbacks.
iOS | Android | macOS | Windows |
---|---|---|---|
Web | Flutter | React Native | |
The following table describes only the operation-specific request parameters and some common request parameters. For the complete list of common request parameters, see the Public request parameters section of the Accessing Server APIs topic.
Parameter | Type | Required | Description |
---|---|---|---|
FromUserId |
String |
Yes |
The ID of the registered user for whom users are to be unblocked. |
UserIds |
Array of String |
Yes |
The list of users to be unblocked. Up to 20 user IDs can be included, each of which cannot exceed 32 bytes in length. |
The FromUserId
and UserIds
parameters can contain only digits, letters, and the following characters: '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', ' ', '{', '}', '|', '~'.
Request URL:
https://zim-api.zego.im/?Action=RemoveUsersFromBlacklist
&<Common request parameters>
Request body:
{
"FromUserId": "zego_user",
"UserIds": [
"user1",
"user2",
"user3",
"user4"
]
}
Parameter | Type | Description |
---|---|---|
Code |
Number |
The return code. When you request to unblock multiple users at a time, take note of the following items:
|
Message |
String |
The description of the request result. |
RequestId |
String |
The request ID. |
ErrList |
Array of Object |
The list of failed results.
|
UserID |
String |
The ID of the user who fails to be unblocked. |
SubCode |
Number |
The code returned when the request fails. |
{
"Code": 0,
"Message": "success",
"RequestId": "343649807833778782",
"ErrList": [
{
"UserId": "user1",
"SubCode": 660000002
}
]
}
The following table describes only the return codes related to the business logic of the operation. For the complete list of return codes, see Return codes.
Return Code | Description | Solution |
---|---|---|
660000002 |
Invalid parameter. |
Check the input parameter. |
660300005 |
The QPS limit specified in AppID is exceeded. |
Try again later. |
660500002 |
FromUserId is not registered. |
Check whether the user is registered. - If so, contact ZEGOCLOUD technical support. - If not, register the user. |
660800001 |
FromUserId is not registered. |
Check whether the user is registered. - If so, contact ZEGOCLOUD technical support. - If not, register the user. |
660800038 |
FromUserId cannot be blocked or unblocked. |
Modify the value of the UserIds parameter. |
660800039 |
Too many users are included in the list. |
Reduce the number of users. |
660800042 |
Failed to unblock all specified users. |
For more information, see SubCode of ErrList . |
660800043 |
This user has been unblocked. |
No handling is required. |
660800044 |
This user is not on the blocklist. |
No handling is required. |