獲取用戶列表
獲取用戶列表
公眾號(hào)可通過本接口來獲取帳號(hào)的關(guān)注者列表，關(guān)注者列表由一串OpenID（加密后的微信號(hào)，每個(gè)用戶對(duì)每個(gè)公眾號(hào)的OpenID是唯一的）組成。一次拉取調(diào)用最多拉取10000個(gè)關(guān)注者的OpenID，可以通過多次拉取的方式來滿足需求。
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: GET（請(qǐng)使用https協(xié)議）
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID
| 參數(shù) | 是否必須 | 說明 |
| access_token | 是 | 調(diào)用接口憑證 |
| next_openid | 是 | 第一個(gè)拉取的OPENID，不填默認(rèn)從頭開始拉取 |
返回說明
正確時(shí)返回JSON數(shù)據(jù)包：
{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}
| 參數(shù) | 說明 |
| total | 關(guān)注該公眾賬號(hào)的總用戶數(shù) |
| count | 拉取的OPENID個(gè)數(shù)，最大值為10000 |
| data | 列表數(shù)據(jù)，OPENID的列表 |
| next_openid | 拉取列表的最后一個(gè)用戶的OPENID |
錯(cuò)誤時(shí)返回JSON數(shù)據(jù)包（示例為無效AppID錯(cuò)誤）：
{"errcode":40013,"errmsg":"invalid appid"}
附：關(guān)注者數(shù)量超過10000時(shí)
當(dāng)公眾號(hào)關(guān)注者數(shù)量超過10000時(shí)，可通過填寫next_openid的值，從而多次拉取列表的方式來滿足需求。
具體而言，就是在調(diào)用接口時(shí)，將上一次調(diào)用得到的返回中的next_openid值，作為下一次調(diào)用中的next_openid值。
示例如下：
公眾賬號(hào)A擁有23000個(gè)關(guān)注的人，想通過拉取關(guān)注接口獲取所有關(guān)注的人，那么分別請(qǐng)求url如下：https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN 返回結(jié)果:
{
"total":23000,
"count":10000,
"data":{"
openid":[
"OPENID1",
"OPENID2",
...,
"OPENID10000"
]
},
"next_openid":"OPENID10000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1返回結(jié)果:
{
"total":23000,
"count":10000,
"data":{
"openid":[
"OPENID10001",
"OPENID10002",
...,
"OPENID20000"
]
},
"next_openid":"OPENID20000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2返回結(jié)果（關(guān)注者列表已返回完時(shí)，返回next_openid為空）:
{
"total":23000,
"count":3000,
"data":{"
"openid":[
"OPENID20001",
"OPENID20002",
...,
"OPENID23000"
]
},
"next_openid":"OPENID23000"
}
{
"total":23000,
"count":10000,
"data":{"
openid":[
"OPENID1",
"OPENID2",
...,
"OPENID10000"
]
},
"next_openid":"OPENID10000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1返回結(jié)果:
{
"total":23000,
"count":10000,
"data":{
"openid":[
"OPENID10001",
"OPENID10002",
...,
"OPENID20000"
]
},
"next_openid":"OPENID20000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2返回結(jié)果（關(guān)注者列表已返回完時(shí)，返回next_openid為空）:
{
"total":23000,
"count":3000,
"data":{"
"openid":[
"OPENID20001",
"OPENID20002",
...,
"OPENID23000"
]
},
"next_openid":"OPENID23000"
}