In-app Chat
  • iOS : Objective-C
  • Android
  • Web
  • Flutter
  • React Native
  • Unity3D
  • Windows
  • macOS
  • Introduction
    • Overview
    • Basic concepts
  • Sample app
  • Getting started
  • Client SDKs
    • SDK downloads
    • Release notes
    • Upgrade guide
  • Guides
    • Authentication
    • Manage users
    • Room
    • Group
    • Messaging
    • Call invitation (signaling)
    • Manage sessions
  • Offline push notifications
  • Error codes
  • Client APIs
  • Server APIs
  • Documentation
  • In-app Chat
  • Server APIs
  • User related
  • Check blockships

Check blockships

Last updated:2024-03-19 10:53

Overview

You can call this operation to batch check the blockships of a user between up to 20 users, that is, whether the user blocks them. If you need a higher limit, contact ZEGOCLOUD technical support.

Operation prototype

  • Request method: POST
  • Request URL: https://zim-api.zego.im/?Action= CheckUsersIsInBlacklist
  • Protocol: HTTPS
  • QPS limit: 20 calls per second

Request parameters

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 whose blockships are to be checked.
UserIds
Array of String
Yes
The list of users to be checked. Up to 20 user IDs can be included.

The FromUserId and UserIds parameters can contain only digits, letters, and the following characters: '!', '#', '$', '%', '&', '(', ')', '+', '-', ':', ';', '<', '=', '.', '>', '?', '@', '[', ']', '^', '_', ' ', '{', '}', '|', '~'.

Sample request

  • Request URL:

    https://zim-api.zego.im/?Action=CheckUsersIsInBlacklis
    &<Common request parameters>
  • Request body:

    {
        "FromUserId": "zego_user",
        "UserIds": [
            "user1",
            "user2",
            "user3",
            "user4"
        ]
    }

Response parameters

Parameter Type Description
Code
Number
The return code.
When you request to check the blockships between FromUserId and multiple users, take note of the following items:
  • If one or more blockships are successfully checked, 0 is returned. For more information, see ErrList.
  • If all blockships fail to be checked, a corresponding code is returned. For more information, see Return codes.
Message
String
The description of the request result.
RequestId
String
The request ID.
Succ
Array of Object
The list of successful results.
UserId
String
The ID of the user whose blockship with FromUserId is successfully checked.
Result
Number
The check result. Valid values:
  • 0: not blocked.
  • 1: blocked.
ErrList
Array of Object
The list of failed results.

  • If `Code` is `0`:
    • If `ErrList` is empty, the blockships between `FromUserId` and all specified users are successfully checked.
    • If `ErrList` is not empty, the blockships between `FromUserId` and some specified users fail to be checked. In this case, see `SubCode`.
  • If `Code` is not `0`:
    • If `ErrList` is empty, one or more parameters are invalid, the QPS limit is exceeded, or a system error occurs.
    • If `ErrList` is not empty, the blockships between `FromUserId` and all specified users fail to be checked.
UserID
String
The ID of the user whose blockship with FromUserId fails to be checked.
SubCode
Number
The code returned when the request fails.

Sample response

{
    "Code": 0,
    "Message": "success",
    "RequestId": "343649807833778782",
    "Succ": [
        {
            "UserId": "user1",
            "Result": 1
        },
        {
            "UserId": "user2",
            "Result": 1
        }
    ],
    "ErrList": [
        {
            "UserId": "user3",
            "SubCode": 660000002
        },
        {
            "UserId": "user4",
            "SubCode": 660000002
        }
    ]
}

Return codes

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.
660700015
The target user 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.
660800039
Too many users are included in the list.
Reduce the number of users.
Page Directory