제품 소개

제품 개요

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 정책

개인 정보 보호 정책

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

에러 코드

문의하기

Deleting Subscribers

PDF

Focus Mode

Font Size

Last updated: 2025-10-23 15:24:45

Feature Overview
This API is used by the app administrator to make a user unsubscribe from an official channel and be removed from the list of subscribers.
Note:
The feature is only available for Enterprises. To enable it, contact us. You can trial this feature in the console. The trial version allows creating up to 5 public accounts, valid for one month.
API Calling Description
Sample Request URL
https://xxxxxx/v4/official_account_open_http_svc/delete_subscriber?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Request Parameters
The table below only lists the parameters modified when this API is called and their descriptions. For details on the parameters, refer to RESTful API Overview.
Parameter
Description
xxxxxx
The dedicated domain name corresponding to the country/region of the SDKAppID:
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/official_account_open_http_svc/delete_subscriber
Request API.
sdkappid
The SDKAppID assigned by the Chat console when an application is created.
identifier
The app admin account. For details, see App Admin.
usersig
The signature generated by the app admin account. For details, see Generating UserSig.
random
A random 32-bit unsigned integer ranging from 0 to 4294967295.
contenttype
The value is always json.
Maximum Call Frequency
200 times/second
Sample Request Packets
{
    "Official_Account": "@TOA#_@TOA#dOEF",  // The desired official channel (required)
    "SubscriberToDel_Account": [        ////UserID of the subscriber to be deleted
        "107867",
        "966582476"
    ]
}
Request Fields
Field
Type
Required
Description
Official_Account
String
Yes
ID of the official channel to be subscribed to. Use the OfficialAccountUserID field returned by the API during creation.
SubscriberList
Array
Yes
Array of subscribers to be added.
Subscriber_Account
String
Yes
UserID of the subscriber to be added.
﻿
Sample Response Packets
{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0,
    "SubscriberList": [
        {
            "Subscriber_Account": "107867",
            "Result": 1
        },
        {
            "Subscriber_Account": "966582476",
            "Result": 1
        }
    ]
}
Response Fields
Field
Type
Description
ActionStatus
String
Processing result:
OK: succeeded.
FAIL: failed.
ErrorCode
Integer
Error code:
0: succeeded.
Other values: failed.
ErrorInfo
String
Error information.
SubscriberList
Array
Returned results of deleted subscribers.
Subscriber_Account
String
Returned subscriber UserID.
Result
Integer
Deletion result:
0: failed.
1: succeeded.
2: not subscribed to this official channel.
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 packets represent the actual error code and error information.
For common error codes (60000 to 79999), see Error Codes.
The following table describes the error codes specific to this API:
Error Code
Description
6017
Invalid request parameter. Please modify and retry.
10004
Internal server error. Please try again.
20001
Invalid request packet. Please modify and retry.
20005
Internal server error. Please try again.
130002
Insufficient operation permissions. Please check the request parameters based on the error message.
130004
The official channel user does not exist, or once existed but has now been terminated.
130007
Incorrect official channel user ID. Please modify and retry.
130008
The official channel user ID is already in use.
131000
This AppId has not been enabled with official channel service.
References
﻿Creating Official Accounts﻿
﻿Adding Subscribers﻿
Possibly Triggered Callbacks
﻿After a Subscriber Is Deleted﻿
﻿
﻿

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

Parameter	Description
xxxxxx	The dedicated domain name corresponding to the country/region of the SDKAppID: 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/official_account_open_http_svc/delete_subscriber	Request API.
sdkappid	The SDKAppID assigned by the Chat console when an application is created.
identifier	The app admin account. For details, see App Admin.
usersig	The signature generated by the app admin account. For details, see Generating UserSig.
random	A random 32-bit unsigned integer ranging from 0 to 4294967295.
contenttype	The value is always `json`.

Field	Type	Required	Description
Official_Account	String	Yes	ID of the official channel to be subscribed to. Use the OfficialAccountUserID field returned by the API during creation.
SubscriberList	Array	Yes	Array of subscribers to be added.
Subscriber_Account	String	Yes	UserID of the subscriber to be added.

Error Code	Description
6017	Invalid request parameter. Please modify and retry.
10004	Internal server error. Please try again.
20001	Invalid request packet. Please modify and retry.
20005	Internal server error. Please try again.
130002	Insufficient operation permissions. Please check the request parameters based on the error message.
130004	The official channel user does not exist, or once existed but has now been terminated.
130007	Incorrect official channel user ID. Please modify and retry.
130008	The official channel user ID is already in use.
131000	This AppId has not been enabled with official channel service.

tencent cloud

Chat

Deleting Subscribers

Feature Overview

API Calling Description

Sample Request URL

Request Parameters

Maximum Call Frequency

Sample Request Packets

Request Fields

Sample Response Packets

Response Fields

Error Codes

References

Possibly Triggered Callbacks

Help and Support