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