net.sf.weixinmp.saas.dialog.user.ListUserRequest Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of weixinmp4j Show documentation
Chinese Wechat SaaS API
The newest version!
package net.sf.weixinmp.saas.dialog.user;

import java.util.Iterator;

import net.sf.weixinmp.saas.WeixinmpRequest;

import com.google.gson.JsonArray;
import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;

/*
 公众号可通过本接口来获取帐号的关注者列表，关注者列表由一串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":[
        "OPENID1",
        "OPENID2",
        ...,
        "OPENID10000"
     ]
   },
   "next_openid":"NEXT_OPENID1"
}
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":"NEXT_OPENID2"
}
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":" "
}
 */
public class ListUserRequest extends WeixinmpRequest{
	private int index=0;
	private int grantIndex = 0;
	private int count = 0;
	private int total = 0;
	private String nextOpenId="";
	private JsonArray current =null;
	/**
	 * 粉丝的openid列表
	 * @param accessToken
	 * @return
	 */
	public Iterator execute(final String accessToken){
		
		initialRequest(accessToken);
		
		Iterator it= new Iterator() {
			public boolean hasNext() {
				if(count==0){
					return false;
				}
				
				if(index