取得使用者列表
取得使用者清單
#公眾號碼可透過此介面取得帳號的追蹤者列表,追蹤者列表由一串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"
]
{
"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"
]
##