Query Banned Users in a Chatroom

Retrieve the list of users banned from a specified chatroom. Banned users cannot re-enter the chatroom during the ban period.

Request Method

POST: https://data center domain/chatroom/user/block/list.json

Rate Limit: 100 requests per second

Signature Rule: All server-side API requests must follow the signature rule. For details, refer to API Request Signature.

Body Parameters

The HTTP request body is in application/x-www-form-urlencoded format and supports the following HTTP form parameters:

Parameter	Type	Required	Description
chatroomId	String	Yes	The chatroom ID.

Request Example

POST /chatroom/user/block/list.json HTTP/1.1
Host: api.rong-api.com
App-Key: uwd1c0sxdlx2
Nonce: 14314
Timestamp: 1408710653491
Signature: 45beb7cc7307889a8e711219a47b7cf6a5b000e8
Content-Type: application/x-www-form-urlencoded

chatroomId=16

Response

The HTTP response body contains a JSON object with the following structure:

Return Value	Type	Description
code	Number	The return code, 200 indicates success.
users	String	An array of banned users.
time	String	The unban time. Precise to the second, formatted as YYYY-MM-DD HH:MM:SS, e.g., 2022-09-25 16:12:38. Note: The value of time depends on the data center your app uses. For apps using the China (Beijing) Data Center, time is in Beijing time. For apps using the global data center, time is in UTC.
userId	String	The ID of the banned user.

Response Example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "code":200,
  "users":[{
    "time":"2015-09-25 16:12:38",
    "userId":"2582"
  }]
}