黑名單管理

公眾號可登入微信公眾平台，對粉絲進行拉黑的操作。同時，我們也提供了一套黑名單管理API，以便開發者直接利用介面進行操作。

1. 取得公眾號碼的黑名單清單

公眾號可透過此介面取得帳號的黑名單列表，黑名單列表由一串OpenID（加密後的微訊號，每個使用者對每個公眾號碼的OpenID是唯一的）組成。

此介面每次呼叫最多可拉取 10000 個OpenID，當清單數較多時，可以透過多次拉取的方式來滿足需求。

介面呼叫請求說明

#

http请求方式：POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/tags/members/getblacklist?access_token=ACCESS_TOKEN

JSON 資料說明

{
	"begin_openid":"OPENID1"
}

當 begin_openid 為空時，預設會從開頭拉取。

返回說明

# 正確時回傳JSON封包

{
 "total":23000,
 "count":10000,
 "data":{"
    openid":[
       "OPENID1",
       "OPENID2",
       ...,
       "OPENID10000"
    ]
  },
  "next_openid":"OPENID10000"
}

錯誤時傳回JSON封包（範例為無效AppID錯誤）

{"errcode":40013,"errmsg":"invalid appid"}

########################################## ##40003

回傳碼	說明
#-1	系統繁忙

###已傳入非法的openid############49003######傳入的openid不屬於此AppID####### ######

同時，請注意：

當公眾號黑名單列表數量超過10000 時，可透過填入next_openid 的值，從而多次拉取列表的方式來滿足需求。

具體而言，就是在呼叫介面時，將上一次呼叫得到的返回中的 next_openid 的值，作為下一次呼叫中的 next_openid 值。

2. 拉黑用戶

#2.來拉黑一批用戶，黑名單列表由一串OpenID （加密後的微訊號，每個用戶對每個公眾號的OpenID是唯一的）組成。

介面呼叫請求說明

####

http请求方式：POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/tags/members/batchblacklist?access_token=ACCESS_TOKEN

參數說明

##

參數	是否必須	說明
access_token	是	呼叫介面憑證
openid_list	是	需要拉入黑名單的使用者的openid，一次拉黑最多允許20個

JSON 資料說明

{
 "opened_list":["OPENID1”,” OPENID2”]
}

#返回說明

##正確時回傳JSON封包

#

{
"errcode": 0,
"errmsg": "ok"
}

######錯誤時傳回JSON封包（範例為無效AppID錯誤）###################

{"errcode":40013,"errmsg":"invalid appid"}

########################################## ##40003已傳入非法的openid49003

回傳碼	說明
#-1	系統繁忙

###傳入的openid不屬於此AppID####### ######40032######一次只能封鎖20個使用者############

3. 取消拉黑用户

公众号可通过该接口来取消拉黑一批用户，黑名单列表由一串OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的）组成。

接口调用请求说明

http请求方式：POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/tags/members/batchunblacklist?access_token=ACCESS_TOKEN

參數說明

##

參數	是否必須	說明
access_token	是	呼叫介面憑證
openid_list	是	需要拉入黑名單的使用者的openid，一次拉黑最多允許20個

JSON 資料說明

{
 "opened_list":["OPENID1”,” OPENID2”]
}

#返回說明

正確時傳回JSON數據套件

{
"errcode": 0,
"errmsg": "ok"
}

#錯誤時傳回JSON封包（範例為無效AppID錯誤）

{"errcode":40013,"errmsg":"invalid appid"}

#

回傳碼說明

40003已傳入非法的openid49003

回傳碼	說明
#-1	系統繁忙

傳入的openid不屬於此AppID