# 基本介绍

微信参考文档

http://mp.weixin.qq.com/wiki/1/4a566d20d67def0b3c1afc55121d2419.html

# 获取用户基本信息

//openid:普通用户的标识,对当前公众号唯一
$openid='';
WeChat::instance('user')->getUserInfo($openid);

# 批量获取用户基本信息

开发者可通过该接口来批量获取用户基本信息。最多支持一次拉取100条。

$data = [
	"user_list" => [
		[
			"openid" => "",
			"lang"   => "zh-CN",
		],
	],
];
$user = WeChat::instance('user')->getUserInfoLists($data);

# 获取用户列表

一次拉取调用最多拉取10000个关注者的OpenID,可以通过多次拉取的方式来满足需求。

当公众号关注者数量超过10000时,可通过填写next_openid的值,从而多次拉取列表的方式来满足需求。 具体而言,就是在调用接口时,将上一次调用得到的返回中的next_openid值,作为下一次调用中的next_openid值。

//从第1个用户拉取
$user = WeChat::instance('user')->getUserLists();
//从上次拉取最后一个用户继续获取
$user = (new Weixin())->instance('user')->getUserLists($user['next_openid']);

# 黑名单管理

# 获取黑名单

公众号可通过该接口来获取帐号的黑名单列表,黑名单列表由一串 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"
]