微信公眾號黑名單管理

2019-03-14 12:08 更新

黑名單管理

公眾號可登錄微信公眾平臺,對粉絲進(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"}

返回碼說明

返回碼說明
-1系統(tǒng)繁忙
40003傳入非法的openid
49003傳入的openid不屬于此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ù)說明

參數(shù)是否必須說明
access_token調(diào)用接口憑證
openid_list需要拉入黑名單的用戶的openid,一次拉黑最多允許20個

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

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

返回說明

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

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

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

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

返回碼說明

返回碼說明
-1系統(tǒng)繁忙
40003傳入非法的openid
49003傳入的openid不屬于此AppID
40032一次只能拉黑20個用戶


3. 取消拉黑用戶

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

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

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

參數(shù)說明

參數(shù)是否必須說明
access_token調(diào)用接口憑證
openid_list需要拉入黑名單的用戶的openid,一次拉黑最多允許20個

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

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

返回說明

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

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

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

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

返回碼說明

返回碼說明
-1系統(tǒng)繁忙
40003傳入非法的openid
49003傳入的openid不屬于此AppID
40032一次只能拉黑20個用戶
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號