Pulling a Blacklist

Prev Next

search by keyword

Recent Pages

Documentation

Download PDF

Last updated: 2021-09-28 20:05:33

Download PDF

Feature Description

This API is used pull a blocklist by page.

API Invocation Description

Request URL example

https://xxxxxx/v4/sns/black_list_get?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json

Request parameters

The following table lists and describes only the parameters to be modified when this API is invoked. For details on other parameters, see RESTful API Overview.

Parameter	Description
https	The request protocol is HTTPS, and the request method is POST.
xxxxxx	The country/region where your SDKAppID is located. China: `console.tim.qq.com` Singapore: `adminapisgp.im.qcloud.com` Seoul: `adminapikr.im.qcloud.com` Frankfurt: `adminapiger.im.qcloud.com`
v4/sns/black_list_get	Request API
sdkappid	SDKAppID assigned by the IM console when an application is created
identifier	This must be the app admin account. For details, see App Admins.
usersig	The signature generated by the app admin account. For details, see Generating UserSig.
random	Enter a random 32-bit unsigned integer ranging from 0 to 4294967295.

Maximum invocation frequency

The maximum invocation frequency is 200 times per second.

Request packet example

{
"From_Account": "id",
"StartIndex": 0,
"MaxLimited": 30,
"LastSequence": 12
}

Request packet fields

Field	Type	Attribute	Description
From_Account	String	Required	The identifier of the blocklist to be pulled.
StartIndex	Integer	Required	The starting pull position.
MaxLimited	Integer	Required	The maximum number of blocked users that can be pulled on each page.
LastSequence	Integer	Required	The sequence that was returned by the server to the client during the previous blocklist pull. Its value is 0 for the initial pull.

Response packet examples

{
"BlackListItem": [
{
"To_Account": "id1",
"AddBlackTimeStamp": 1430000001
},
{
"To_Account": "id2",
"AddBlackTimeStamp": 1430000002
}
],
"StartIndex": 0,
"CurruentSequence": 13,
"ActionStatus": "OK",
"ErrorCode": 0,
"ErrorInfo": "",
"ErrorDisplay": ""
}

Response packet fields

Field	Type	Description
BlackListItem	Array	The blocklist object array. Each blocklist object includes To_Account and AddBlackTimeStamp.
To_Account	String	The identifier of a blocklist.
AddBlackTimeStamp	Integer	The time when users was added to the blocklist.
StartIndex	Integer	The starting pull position on the next page. The 0 value indicates that the pull is completed.
CurruentSequence	Integer	The latest sequence of the blocklist.
ActionStatus	String	The request processing result. OK: succeeded. FAIL: failed.
ErrorCode	Integer	The error code. 0: succeeded. Others: failed.
ErrorInfo	String	The detailed error information.
ErrorDisplay	String	The detailed error information to be displayed on the client.

Error Codes

Unless a network error (such as error 502) occurs, the HTTP return code for this API is always 200. ErrorCode and ErrorInfo in the response packet represent the actual error code and error information, respectively.
For common error codes (60000 to 79999), see Error Codes.
The following table describes the error codes specific to this API.

Error Code	Description
30001	A request parameter is incorrect. In this case, check request parameters based on the error description.
30003	The requested user account does not exist.
30004	The request requires app admin permissions.
30006	An internal server error occurred. In this case, try again.
30007	The network connection timed out. In this case, try again later.

API Commissioning Tool

Use the RESTful online commissioning tool for APIs to commission this API.

References

Adding users to blocklist (v4/sns/black_list_add).
Removing users from blocklist (v4/sns/black_list_delete).
Verifying a blocklist (v4/sns/black_list_check).

Recent Pages