Skip to main content

get_black_list

Description

  • Retrieve the blacklist of a specific user.

Request Method

  • post

Request URL

  • {API_ADDRESS}/friend/get_black_list
Header NameExample ValueOptionalTypeDescription
operationID1646445464564RequiredstringUsed for global traceability, recommended to use a timestamp for uniqueness in each request.
tokeneyJhbxxxx3XsRequiredstringAdmin token

Request Body Example

{
"userID": "11111111",
"pagination": {
"pageNumber": 1,
"showNumber": 100
}
}
Field NameOptionalTypeDescription
userIDRequiredstringUser ID
paginationRequiredobjectPagination details
pagination.pageNumberRequiredintCurrent page number, starts from 1
pagination.showNumberRequiredintNumber of entries per page

Success Response Example

{
"errCode": 0,
"errMsg": "",
"errDlt": "",
"data": {
"blacks": [
{
"ownerUserID": "11111111",
"createTime": 1688460626,
"blackUserInfo": {
"userID": "11111113",
"nickname": "yourNickname",
"faceURL": "yourFaceURL",
"ex": ""
},
"addSource": 0,
"operatorUserID": "openIMAdmin",
"ex": ""
}
],
"total": 1
}
}

Success Response Parameters

Parameter NameTypeDescription
errCodeintError code, 0 means success
errMsgstringBrief error message, empty if successful
errDltstringDetailed error message, empty if successful
dataobjectData object, see structure below
blacksarrayList of blacklist information
totalintTotal number of blacklist entries

Failure Response Example

{
"errCode": 1004,
"errMsg": "RecordNotFoundError",
"errDlt": ": [1004]RecordNotFoundError"
}

Failure Response Parameters

Parameter NameTypeDescription
errCodeintError code, refer to the global error code documentation
errMsgstringBrief error message
errDltstringDetailed error message