제품 소개

제품 개요

Basic Concepts

응용 시나리오

기능 소개

계정 시스템

사용자 정보 및 관계망

메시지 관리

그룹 시스템

Official Account

Audio/Video Call

사용 제한

구매 가이드

과금 개요

요금 안내

Purchase Instructions

Renewal Guide

연체 안내

Refund Policy

다운로드 센터

SDK & Demo 소스 코드

업데이트 로그

시나리오 솔루션

Live Streaming Setup Guide

AI Chatbot

대규모 엔터테인먼트 협업 커뮤니티

Discord 구현 가이드

IM을 게임에 통합하는 방법

WhatsApp Channel-style Official Account Integration Solution

Send Red Packet

Firewall Restrictions

클라이언트 APIs

SDK API(Web)

Android

iOS & macOS

Swift

Flutter

Electron

Unity

React Native

C APIs

C++

서버 APIs

Secure authentication with UserSig

RESTful APIs

Webhooks

콘솔 가이드

New Console Introduction

애플리케이션 생성 및 업그레이드

기본 설정

기능 설정

계정 관리

그룹 관리

Official Channel Management

콜백 설정

모니터링 대시보드

Viewing Guide for Resource Packages

Real-Time Monitor

개발 보조 툴

액세스 관리

Advanced Features

FAQ

uni-app FAQs

구매

SDK 관련 질문

계정 인증

사용자 정보 및 관계망

메시지

그룹

라이브 방송 그룹

닉네임 및 프로필 사진

협약 및 인증

Service Level Agreement

컴플라이언스 인증

IM 정책

개인 정보 보호 정책

데이터 개인 정보 보호 및 보안 계약

에러 코드

문의하기

Unblocklisting Users

PDF

포커스 모드

폰트 크기

마지막 업데이트 시간: 2025-10-23 15:01:16

Feature Description
This API is used to remove one or multiple users from the blocklist.
API Invocation Description
Request URL example
https://xxxxxx/v4/sns/black_list_delete?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
Tokyo：adminapijpn.im.qcloud.com
Frankfurt: adminapiger.im.qcloud.com
Silicon Valley: adminapiusa.im.qcloud.com
Jakarta: adminapiidn.im.qcloud.com
v4/sns/black_list_delete
The Request API.
sdkappid
The SDKAppID assigned by the Chat 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.
contenttype
Request format. The value is always json.
Maximum invocation frequency
The maximum invocation frequency is 200 times per second.
Request packet example
{
 "From_Account":"id",
 "To_Account":["id1","id2","id3"]
}
Request packet fields
Field
Type
Attribute
Description
From_Account
String
Required
The identifier for which specific users are to be removed from their blocklist.
To_Account
Array
Required
The list of identifiers to be removed from the blocklist. The number of To_Accounts in a single request cannot exceed 1,000.
Response packet example
{
"ResultItem":
[
{
"To_Account":"id1",
"ResultCode":0,
"ResultInfo":""
},
{
"To_Account":"id2",
"ResultCode":0,
"ResultInfo":""
},
{
"To_Account":"id3",
"ResultCode":30006,
"ResultInfo":"Err_SNS_BlackListCheck_Check_Reverse_BlackList_Fail"
}
],
"Fail_Account":["id3"],
"ActionStatus":"OK",
"ErrorCode":0,
"ErrorInfo":"",
"ErrorDisplay":""
}
Response packet fields
Field
Type
Description
ResultItem
Array
The result object array for batch deletion from blocklist.
To_Account
String
The identifier you request to be removed from the blocklist.
ResultCode
Integer
The processing result of To_Account. 0: succeeded. Others: failed.
ResultInfo
String
Error description for To_Account. If the processing is successful, the field is empty.
Fail_Account
Array
The list of users that fails to be removed. This field is returned only when someone fails to be removed.
ActionStatus
String
The request packet processing result. OK: succeeded. FAIL: failed.
ErrorCode
Integer
The error code. 0: succeeded. Others: failed.
ErrorInfo
String
Detailed error information.
ErrorDisplay
String
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.
30008
A write conflict occurred due to concurrent writes. In this case, we recommend that you use the batch mode.
API Commissioning Tool
Use the online commissioning tool for RESTful APIs to commission this API.
References
﻿Removing users from blocklist 
﻿Pulling a blocklist 
﻿Verifying a blocklist 
Callback That May Be Triggered
﻿Callback after removing users from blocklist﻿

도움말 및 지원

문제 해결에 도움이 되었나요?

더 자세한 내용은 문의하기 또는 티겟 제출 을 통해 문의할 수 있습니다.

피드백

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` Tokyo：`adminapijpn.im.qcloud.com` Frankfurt: `adminapiger.im.qcloud.com` Silicon Valley: `adminapiusa.im.qcloud.com` Jakarta: `adminapiidn.im.qcloud.com`
v4/sns/black_list_delete	The Request API.
sdkappid	The SDKAppID assigned by the Chat 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.
contenttype	Request format. The value is always `json`.

Field	Type	Attribute	Description
From_Account	String	Required	The identifier for which specific users are to be removed from their blocklist.
To_Account	Array	Required	The list of identifiers to be removed from the blocklist. The number of To_Accounts in a single request cannot exceed 1,000.

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.
30008	A write conflict occurred due to concurrent writes. In this case, we recommend that you use the batch mode.

tencent cloud

Chat

Unblocklisting Users

Feature Description

API Invocation Description

Request URL example

Request parameters

Maximum invocation frequency

Request packet example

Request packet fields

Response packet example

Response packet fields

Error Codes

API Commissioning Tool

References

Callback That May Be Triggered

도움말 및 지원