微信公众平台 获取用户列表
一、接口说明
公众号可通过本接口来获取帐号的关注者列表，关注者列表由一串OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的）组成。一次拉取调用最多拉取10000个关注者的OpenID，可以通过多次拉取的方式来满足需求。
二、接口调用
1 接口调用请求说明
（1）http请求方式: GET（请使用https协议）
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID
（2）请求参数
参数 是否必须 说明
access_token 是 调用接口凭证
next_openid 是 第一个拉取的OPENID，不填默认从头开始拉取
2 接口调用返回说明
（1）正确时返回JSON数据包
{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}
（2）返回参数
参数 说明
total 关注该公众账号的总用户数
count 拉取的OPENID个数，最大值为10000
data 列表数据，OPENID的列表
next_openid 拉取列表的最后一个用户的OPENID
附：关注者数量超过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":"OPENID10000"
}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":"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"
]
},
"next_openid":"OPENID23000"
}
三、java接口开发
注：此接口开发使用spring的RestTemplate方法进行http请求，如果不使用此方法可以使用其他http请求工具或方法进行http的请求。此方法仅供参考！
1 返回参数对象WeixinUserList
/** * 类描述：微信公众平台用户openId列表信息 * 开发人员：wangqiulin * 开发时间：2017-9-5 */ public class WeixinUserList { private Integer total;//关注该公众账号的总用户数 private Integer count;//拉取的OPENID个数，最大值为10000 private WxOpenidInfo data;//列表数据，OPENID的列表 private String next_openid;//拉取列表的最后一个用户的OPENID private int errcode;//错误编码 private String errmsg="ok";//错误提示 public Integer getTotal() { return total; } public void setTotal(Integer total) { this.total = total; } public Integer getCount() { return count; } public void setCount(Integer count) { this.count = count; } public String getNext_openid() { return next_openid; } public void setNext_openid(String next_openid) { this.next_openid = next_openid; } public WxOpenidInfo getData() { return data; } public void setData(WxOpenidInfo data) { this.data = data; } public int getErrcode() { return errcode; } public void setErrcode(int errcode) { this.errcode = errcode; } public String getErrmsg() { return errmsg; } public void setErrmsg(String errmsg) { this.errmsg = errmsg; } } openidList集合对象 import java.util.List; public class WxOpenidInfo { private List<string> openid; public List<string> getOpenid() { return openid; } public void setOpenid(List<string> openid) { this.openid = openid; } }
2 接口方法
将获取到的openid集合写入txt文件，写入数据库也类似
public WeixinUserList getUserOpenIdList(String nextOpenid, String accessToken) { //用户openid列表信息 WeixinUserList openIdListInfo = null; synchronized(this){ try { //循环获取用户openid列表 do{ //微信公众号获取用户列表信息接口地址 String requestUrl = null; if(StringUtils.isBlank(nextOpenid)){ requestUrl = new StringBuffer().append("https://api.weixin.qq.com/cgi-bin/user/get?access_token=").append(accessToken).toString(); }else { requestUrl = new StringBuffer().append("https://api.weixin.qq.com/cgi-bin/user/get?access_token=") .append(accessToken).append("&next_openid=").append(nextOpenid).toString(); } openIdListInfo = restTemplate.getForObject(requestUrl, WeixinUserList.class); if(openIdListInfo != null && openIdListInfo.getErrcode() == 0){ //获取用户openid列表对象 WxOpenidInfo wxOpenidInfo = openIdListInfo.getData(); if(wxOpenidInfo != null){ List<string> openids = wxOpenidInfo.getOpenid(); if(openids != null && openids.size() > 0){ //生成数据的表头 StringBuffer text = new StringBuffer(); for (String openid : openids) { //生成数据的内容 text.append(openid+"\r\n"); } //写入txt文件中 writeTxtFile(text.toString()); } //拉取列表的最后一个用户的OPENID nextOpenid = openIdListInfo.getNext_openid(); } }else { openIdListInfo.setErrcode(40000); openIdListInfo.setErrmsg("获取关注用户列表失败"); return openIdListInfo ; } } while (openIdListInfo.getCount() == 10000); } catch (Exception e) { LOG.error("获取用户列表失败",e); openIdListInfo .setErrcode(40000); openIdListInfo .setErrmsg("获取用户列表失败"); return openIdListInfo ; } } return openIdListInfo; }
将获取的openid列表写入txt文件
/** * 写文件 */ public void writeTxtFile(String content) throws IOException{ //指定文件路径和名称 String path = "D:/openidList.txt"; File filename = new File(path); if (!filename.exists()) { filename.createNewFile(); LOG.info(filename + "已创建！"); } //先读取原有文件内容，然后进行写入操作 RandomAccessFile randomAccessFile = null; try { randomAccessFile = new RandomAccessFile(filename, "rw"); // 文件长度，字节数 long fileLength = randomAccessFile.length(); // 将写文件指针移到文件尾。 randomAccessFile.seek(fileLength); randomAccessFile.writeBytes(content); } catch (IOException e1) {
e1.printStackTrace();
} finally {
if (randomAccessFile != null) {
try {
randomAccessFile.close();
} catch (IOException e2) {
e2.printStackTrace();
}
}
}
}
