Get Banned User List
Query the information of banned users, including the user ID and the end time of the ban.
The ban will be automatically lifted after the ban period expires. You can also proactively call the unban method to lift the ban.
Request Method
POST: https://data center domain/user/block/query.json
Rate Limit: 100 requests per second
Signature Rule: All server API requests require signature verification. For details, see API Request Signature.
Body Parameters
The HTTP request body data format is application/x-www-form-urlencoded, and the following HTTP form parameters are supported:
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | Number | No | The current page number when paginating the banned user list. If not passed or set to 0, no pagination will be performed, and the first 1000 banned users will be returned by default, sorted by the ban end time in descending order. |
| size | Number | No | The number of rows per page when paginating the banned user list. If not passed, the default is 50. |
Request Example
POST /user/block/query.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
page=1&size=50
Response
The HTTP response body contains a JSON object with the following structure:
| Return Value | Type | Description |
|---|---|---|
| code | Number | Return code, 200 indicates success. |
| users | Array | Array of banned users. |
| users[i].userId | String | Banned user ID. |
| users[i].blockEndTime | String | Ban end time. |
Response Example
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"code":200,"users":[{"userId":"jlk456j5","blockEndTime":"2015-01-11 01:28:20"}]}