取得使用者列表


取得使用者清單

1474939796871028.png

#公眾號碼可透過此介面取得帳號的追蹤者列表,追蹤者列表由一串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":[
   " 1 ",
       "OPENID2",
       ...,
       "OPENID10000"
    ]
.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1回傳結果:
{
  "total":23000,
  "count":10000,
 ":{
    "openid":[
      "OPENID10001",
      "OPENID10002",
      ...,
 "next_openid":"OPENID20000"
}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"
      ]
 






##