## **接口内容列表**
[TOC]
## **获取微信粉丝全部列表**
* 参数`$openid`默认为空，来自上次获取列表中的`next_openid`字段。
~~~
// 实例微信粉丝接口
$user = & load_wechat('User');
// 读取微信粉丝列表
$result = $user->getUserList($openid);
// 处理创建结果
if($result===FALSE){
// 接口失败的处理
echo $user->errMsg;
}else{
// 接口成功的处理
}
~~~
## **获取指定粉丝详细信息（必需已关注公众号）**
* 参数`$openid`为指定的粉丝用户Openid。
~~~
// 实例微信粉丝接口
$user = & load_wechat('User');
// 读取微信粉丝列表
$result = $user->getUserInfo($openid);
// 处理创建结果
if($result===FALSE){
// 接口失败的处理
echo $user->errMsg;
}else{
// 接口成功的处理
}
~~~
## **设置指定粉丝的备注信息（必需已关注公众号）**
* 参数`$openid`为指定的粉丝用户Openid。
* 参数`$remake`为需要设置的备注信息
~~~
// 实例微信粉丝接口
$user = & load_wechat('User');
// 读取微信粉丝列表
$result = $user->updateUserRemark($openid,$remake);
// 处理创建结果
if($result===FALSE){
// 接口失败的处理
echo $user->errMsg;
}else{
// 接口成功的处理
}
~~~
## **新增粉丝自定义标签**
* 参数`$name`为新建粉丝标签的名称
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//新增粉丝自定义标签
$result = $user->createTags($name);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **更新粉丝自定义标签**
* 参数`$id`为需要修改的粉丝标签ID
* 参数`$name`为粉丝标签的新名称
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//更新粉丝自定义标签
$result = $user->updateTag($id,$name);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **获取粉丝标签列表**
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//获取粉丝标签列表
$result = $user->getTags();
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **删除粉丝标签**
* 参数`$id`为需要删除的粉丝标签ID
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//删除粉丝标签
$result = $user->delTag($id);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **获取标签下的粉丝列表**
* 参数`$tagid`为粉丝标签ID
* 参数`$next_openid`为粉丝Openid（选填参数）
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//获取标签下的粉丝列表
$result = $user->getTagUsers($tagid, $next_openid);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **批量为粉丝打标签**
* 参数`$tagid`为粉丝标签ID
* 参数`$openid_list`为粉丝openid数组，一次不能超过50个
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//批量为粉丝打标签
$result = $user->batchAddUserTag($tagid, $openid_list);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **批量为粉丝取消标签**
* 参数`$tagid`为粉丝标签ID
* 参数`$openid_list`为粉丝openid数组，一次不能超过50个
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//批量为粉丝取消标签
$result = $user->batchDeleteUserTag($tagid, $openid_list);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **获取粉丝的标签列表**
* 参数`$openid`为粉丝的Openid
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//获取粉丝的标签列表
$result = $user->getUserTags($openid);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **批量获取黑名单粉丝**
* 参数`$begin_openid`为粉丝的Openid（选填参数，可为空）
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//批量获取黑名单粉丝
$result = $user->getBacklist($begin_openid);
//处理结果
if($result===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **批量设置粉丝黑粉名单**
* 参数`$openids`为粉丝openid数组，一次只能拉黑20个用户
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//批量拉黑粉丝
$result = $user->addBacklist($openids);
//处理结果
if($result===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **批量取消拉黑粉丝**
* 参数`$openids`为粉丝openid数组，一次只能取消20个用户
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//批量取消拉黑粉丝
$result = $user->delBacklist($openids);
//处理结果
if($result===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **获取粉丝分组列表（已废弃）**
~~~
// 实例微信粉丝接口
$user = & load_wechat('User');
// 读取微信粉丝分组列表
$result = $user->getGroup();
// 处理创建结果
if($result===FALSE){
// 接口失败的处理
echo $user->errMsg;
}else{
// 接口成功的处理
}
~~~
## **删除微信粉丝分组（已废弃）**
* 参数`$id`是微信粉丝分组的ID
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//删除微信粉丝分组
$result = $user->delGroup($id);
//处理删除结果
if($result===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **获取指定粉丝所在分组（已废弃）**
* 参数`$openid`为指定的粉丝用户Openid
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//获取指定粉丝所在分组
$result = $user->getUserGroup($openid);
//处理结果
if($result===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **新增粉丝分组（已废弃）**
* 参数`$name`为所要创建的分组名称
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//新增粉丝分组
$result = $user->createGroup($name);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **更新修改粉丝分组（已废弃）**
* 参数`$groupid`为粉丝分组的ID
* 参数`$name`为粉丝分组的新名称
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//更新修改粉丝分组
$result = $user->updateGroup($groupid,$name);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **移动粉丝所在分组（已废弃）**
* 参数`$groupid`为粉丝分组的ID
* 参数`$openid`为指定的粉丝用户Openid
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//移动粉丝所在分组
$result = $user->updateGroupMembers($groupid,$openid);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **批量移动粉丝所在分组（已废弃）**
* 参数`$groupid`为粉丝分组的ID
* 参数`$openid_list`为粉丝Openid数组(一次不能超过50个)
~~~
//实例微信粉丝接口
$user = & load_wechat('User');
//批量移动粉丝所在分组
$result = $user->batchUpdateGroupMembers($groupid,$openid_list);
//处理结果
if($resule===FALSE){
//接口失败的处理
echo $user->errMsg;
}else{
//接口成功的处理
}
~~~
## **错误码说明**
| 返回码 | 说明 |
| --- | --- |
| \-1 | 系统繁忙 |
| 45157 | 标签名非法，请注意不能和其他标签重名 |
| 45158 | 标签名长度超过30个字符 |
| 45056 | 创建的标签数过多，请注意不能超过100个 |
| 45058 | 不能修改0/1/2这三个系统默认保留的标签 |
| 45057 | 该标签下粉丝数超过10w，不允许直接删除 |
| 40003 | 传入非法的openid |
| 45159 | 非法的tag\_id |
| 40032 | 每次传入的openid列表个数不能超过50个 |
| 45059 | 有粉丝身上的标签数已经超过限制 |
| 49003 | 传入的openid不属于此AppID |
| 40032 | 一次只能拉黑20个用户 |
