一、接口说明

公众号可通过本接口来获取帐号的关注者列表，关注者列表由一串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 classWeixinUserList {private Integer total;//关注该公众账号的总用户数

private Integer count;//拉取的OPENID个数，最大值为10000

private WxOpenidInfo data;//列表数据，OPENID的列表

private String next_openid;//拉取列表的最后一个用户的OPENID

private int errcode;//错误编码

private String errmsg="ok";//错误提示

publicInteger getTotal() {returntotal;

}public voidsetTotal(Integer total) {this.total =total;

}publicInteger getCount() {returncount;

}public voidsetCount(Integer count) {this.count =count;

}publicString getNext_openid() {returnnext_openid;

}public voidsetNext_openid(String next_openid) {this.next_openid =next_openid;

}publicWxOpenidInfo getData() {returndata;

}public voidsetData(WxOpenidInfo data) {this.data =data;

}public intgetErrcode() {returnerrcode;

}public void setErrcode(interrcode) {this.errcode =errcode;

}publicString getErrmsg() {returnerrmsg;

}public voidsetErrmsg(String errmsg) {this.errmsg =errmsg;

}

}

openidList集合对象importjava.util.List;public classWxOpenidInfo {private Listopenid;public ListgetOpenid() {returnopenid;

}public void setOpenid(Listopenid) {this.openid =openid;

}

}

2 接口方法

将获取到的openid集合写入txt文件，写入数据库也类似

publicWeixinUserList 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 openids =wxOpenidInfo.getOpenid();if(openids != null && openids.size() > 0){//生成数据的表头

StringBuffer text = newStringBuffer();for(String openid : openids) {//生成数据的内容

text.append(openid+"\r\n");

}//写入txt文件中

writeTxtFile(text.toString());

}//拉取列表的最后一个用户的OPENID

nextOpenid =openIdListInfo.getNext_openid();

}

}else{

openIdListInfo.setErrcode(40000);

openIdListInfo.setErrmsg("获取关注用户列表失败");returnopenIdListInfo ;

}

}while (openIdListInfo.getCount() == 10000);

}catch(Exception e) {

LOG.error("获取用户列表失败",e);

openIdListInfo .setErrcode(40000);

openIdListInfo .setErrmsg("获取用户列表失败");returnopenIdListInfo ;

}

}returnopenIdListInfo;

}

将获取的openid列表写入txt文件

/**

* 写文件*/

public voidwriteTxtFile(String content) throws IOException{//指定文件路径和名称

String path = "D:/openidList.txt";

File filename= newFile(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();

}

}

}

}