## **接口內容列表**
[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個用戶 |
