微信公眾號(hào)黑名單管理

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

1. 獲取公眾號(hào)的黑名單列表

公眾號(hào)可通過(guò)該接口來(lái)獲取帳號(hào)的黑名單列表，黑名單列表由一串 OpenID（加密后的微信號(hào)，每個(gè)用戶(hù)對(duì)每個(gè)公眾號(hào)的OpenID是唯一的）組成。

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

接口調(diào)用請(qǐng)求說(shuō)明

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

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

{
	"begin_openid":"OPENID1"
}

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

返回說(shuō)明

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

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

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

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

返回碼說(shuō)明

同時(shí)，請(qǐng)注意：

當(dāng)公眾號(hào)黑名單列表數(shù)量超過(guò) 10000 時(shí)，可通過(guò)填寫(xiě) next_openid 的值，從而多次拉取列表的方式來(lái)滿(mǎn)足需求。

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

2. 拉黑用戶(hù)

公眾號(hào)可通過(guò)該接口來(lái)拉黑一批用戶(hù)，黑名單列表由一串 OpenID （加密后的微信號(hào)，每個(gè)用戶(hù)對(duì)每個(gè)公眾號(hào)的OpenID是唯一的）組成。

接口調(diào)用請(qǐng)求說(shuō)明

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

參數(shù)說(shuō)明

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

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

返回說(shuō)明

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

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

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

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

返回碼說(shuō)明

3. 取消拉黑用戶(hù)

公眾號(hào)可通過(guò)該接口來(lái)取消拉黑一批用戶(hù)，黑名單列表由一串OpenID（加密后的微信號(hào)，每個(gè)用戶(hù)對(duì)每個(gè)公眾號(hào)的OpenID是唯一的）組成。

接口調(diào)用請(qǐng)求說(shuō)明

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

參數(shù)說(shuō)明

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

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

返回說(shuō)明

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

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

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

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

返回碼說(shuō)明