製品の説明

製品の概要

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

SDK API（Electron）

SDK APIs (Unity)

SDK API（React Native）

C APIs

C++

サービス側 APIs

UserSigの生成

RESTful APIs

Webhooks

コンソールガイド

New Console Introduction

アプリケーションの作成とアップグレード

基本設定

機能設定

アカウント管理

グループ管理

Official Channel Management

コールバック設定

監視ダッシュボード

Viewing Guide for Resource Packages

Real-Time Monitor

補助ツールの開発

アクセス管理

Advanced Features

よくあるご質問

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

ヘルプとサポート