# 黑名單管理 [TOC] ## 獲取公眾號的黑名單列表 公眾號可通過該接口來獲取帳號的黑名單列表，黑名單列表由一串 OpenID（加密后的微信號，每個用戶對每個公眾號的OpenID是唯一的）組成。 該接口每次調用最多可拉取 10000 個OpenID，當列表數較多時，可以通過多次拉取的方式來滿足需求。 ``` $user = WeChat::instance('user')->getblacklist(); ``` 當用戶較多時可以指定參數從哪個用戶開始獲取。 ``` $user = WeChat::instance('user')->getblacklist(用戶的OPENID); ``` ## 拉黑用戶 公眾號可通過該接口來拉黑一批用戶，黑名單列表由一串 OpenID （加密后的微信號，每個用戶對每個公眾號的OpenID是唯一的）組成。 ``` //用戶的OPENID列表 $openids = ['oGiQGuNCkJCTsc_t61XTrqbyY3rM']; WeChat::instance('user')->batchBlackList($openids); ``` **返回值** ``` [ "errcode"=>0, "errmsg"=> "ok" ] ``` ## 取消拉黑用戶 公眾號可通過該接口來取消拉黑一批用戶，黑名單列表由一串OpenID（加密后的微信號，每個用戶對每個公眾號的OpenID是唯一的）組成。 ``` //用戶的OPENID列表 $openids = ['oGiQGuNCkJCTsc_t61XTrqbyY3rM']; WeChat::instance('user')->batchUnBlackList($openids); ``` **返回值** ``` [ "errcode"=>0, "errmsg"=>"ok" ] ```