微信公眾號黑名單管理

公眾號可登錄微信公眾平臺，對粉絲進(jìn)行拉黑的操作。同時，我們也提供了一套黑名單管理API，以便開發(fā)者直接利用接口進(jìn)行操作。

1. 獲取公眾號的黑名單列表

公眾號可通過該接口來獲取帳號的黑名單列表，黑名單列表由一串 OpenID（加密后的微信號，每個用戶對每個公眾號的OpenID是唯一的）組成。

該接口每次調(diào)用最多可拉取 10000 個OpenID，當(dāng)列表數(shù)較多時，可以通過多次拉取的方式來滿足需求。

接口調(diào)用請求說明

http請求方式：POST（請使用https協(xié)議）
https://api.weixin.qq.com/cgi-bin/tags/members/getblacklist?access_token=ACCESS_TOKEN

JSON 數(shù)據(jù)說明

{
	"begin_openid":"OPENID1"
}

當(dāng) begin_openid 為空時，默認(rèn)從開頭拉取。

返回說明

正確時返回 JSON數(shù)據(jù)包

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

錯誤時返回 JSON數(shù)據(jù)包（示例為無效AppID錯誤）

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

返回碼說明

同時，請注意：

當(dāng)公眾號黑名單列表數(shù)量超過 10000 時，可通過填寫 next_openid 的值，從而多次拉取列表的方式來滿足需求。

具體而言，就是在調(diào)用接口時，將上一次調(diào)用得到的返回中的 next_openid 的值，作為下一次調(diào)用中的 next_openid 值。

2. 拉黑用戶

公眾號可通過該接口來拉黑一批用戶，黑名單列表由一串 OpenID （加密后的微信號，每個用戶對每個公眾號的OpenID是唯一的）組成。

接口調(diào)用請求說明

http請求方式：POST（請使用https協(xié)議）
https://api.weixin.qq.com/cgi-bin/tags/members/batchblacklist?access_token=ACCESS_TOKEN

參數(shù)說明

JSON 數(shù)據(jù)說明

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

返回說明

正確時返回 JSON數(shù)據(jù)包

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

錯誤時返回 JSON數(shù)據(jù)包（示例為無效AppID錯誤）

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

返回碼說明

3. 取消拉黑用戶

公眾號可通過該接口來取消拉黑一批用戶，黑名單列表由一串OpenID（加密后的微信號，每個用戶對每個公眾號的OpenID是唯一的）組成。

接口調(diào)用請求說明

http請求方式：POST（請使用https協(xié)議）
https://api.weixin.qq.com/cgi-bin/tags/members/batchunblacklist?access_token=ACCESS_TOKEN

參數(shù)說明

JSON 數(shù)據(jù)說明

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

返回說明

正確時返回 JSON數(shù)據(jù)包

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

錯誤時返回 JSON數(shù)據(jù)包（示例為無效AppID錯誤）

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

返回碼說明