微信公衆平臺開發(87) 獲取關注者列表

本文介紹在微信公衆平臺上如何使用高級接口開發獲取關注者列表的功能。

 

1、接口介紹

公衆號可經過本接口來獲取賬號的關注者列表，關注者列表由一串OpenID（加密後的微信號，每一個用戶對每一個公衆號的OpenID是惟一的）組成。一次拉取調用最多拉取10000個關注者的OpenID，能夠經過屢次拉取的方式來知足需求。

接口調用請求說明

http請求方式: GET（請使用https協議）
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

參數	是否必須	說明
access_token	是	調用接口憑證
next_openid	是	第一個拉取的OPENID，不填默認從頭開始拉取

返回說明

正確時返回JSON數據包：

{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}

參數	說明
total	關注該公衆帳號的總用戶數
count	拉取的OPENID個數，最大值爲10000
data	列表數據，OPENID的列表
next_openid	拉取列表的後一個用戶的OPENID

錯誤時返回JSON數據包（示例爲無效AppID錯誤）：

{"errcode":40013,"errmsg":"invalid appid"}

附：關注者數量超過10000時

當公衆號關注者數量超過10000時，可經過填寫next_openid的值，從而屢次拉取列表的方式來知足需求。

具體而言，就是在調用接口時，將上一次調用獲得的返回中的next_openid值，做爲下一次調用中的next_openid值。

示例以下：

公衆帳號A擁有23000個關注的人，想經過拉取關注接口獲取全部關注的人，那麼分別請求url以下：
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN 
返回結果:

{
  "total":23000,
  "count":10000,
  "data":{"
     openid":[
        "OPENID1",
        "OPENID2",
        ...,
        "OPENID10000"
     ]
   },
   "next_openid":"NEXT_OPENID1"
}

https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1
返回結果:

{
   "total":23000,
   "count":10000,
   "data":{
     "openid":[
       "OPENID10001",
       "OPENID10002",
       ...,
       "OPENID20000"
     ]
   },
   "next_openid":"NEXT_OPENID2"
}

https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2
返回結果（關注者列表已返回完時，返回next_openid爲空）:

{
   "total":23000,
   "count":3000,
   "data":{"
       "openid":[
         "OPENID20001",
         "OPENID20002",
         ...,
         "OPENID23000"
       ]
   },
   "next_openid":" "
}

2、程序實現

$access_token = "";

$url = "https://api.weixin.qq.com/cgi-bin/user/get?access_token=$access_token";
$result = https_request($url);
$jsoninfo = json_decode($result, true);
var_dump($result);

招行後，返回相似以下：

{
    "total": 200,
    "count": 200,
    "data": {
        "openid": [
            "o7Lp5t6n59DeX3U0C7Kric9qEx-Q",
            "o7Lp5t5BZDl22PcjIliHp03kzgBE"
        ]
    },
    "next_openid": "o7Lp5t5BZDl22PcjIliHp03kzgBE"
}

對於超過1萬之後的數，循環執行上述程序便可，將這些openid存入數據庫，就得到了關注者的列表。

該接口的做用主要是配合獲取用戶基本信息以及用戶分組接口，得到全部關注者的基本信息及分組。

 

====================================================================

方倍工做室微信公衆平臺帳號關注方法：
1. 微信通信錄-添加朋友-查找公衆號-搜索「方倍工做室」
2. 微信通信錄-添加朋友-搜號碼-輸入「pondbaystudio」
3. 使用微信掃描下面的二維碼