**接口内容列表** -- [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个用户 |