# 黑名单管理
[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"
]
```
