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