**接口内容列表**

--

[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个用户 |