公众平台测试帐号开发全流程第7篇-用户管理

用户管理介绍

从微信公众平台开发者文档中可以知道，用户管理下面有五个功能，如下

1. 用户分组管理
2. 设置用户备注名
3. 获取用户基本信息(UnionID机制)
4. 获取用户列表
5. 获取用户地理位置

本篇文章主要讲后面三个功能，获取用户地理位置功能这里不说明，用户分组管理篇幅比较大，放在下篇文章。

获取用户列表

说明

公众号可通过本接口来获取帐号的关注者列表，关注者列表由一串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值。

分析

这个功能对于大部分人来说是挺简单的，只需在链接上添加上对于的值，然后在通过GET访问固定接口就可以得到结果了。

具体实现

在公众平台测试帐号开发全流程第4篇-自定义菜单有封装两个方法，一个是http访问的代码

public class HttpUtils {

    public static InputStream connectHttp(String urlStr,String method,byte[] bs) throws IOException{
        URL url = new URL(urlStr);
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();

        connection.setRequestMethod(method);
        connection.setDoOutput(true);
        connection.setDoInput(true);
        connection.connect();

        if (bs != null) {
            OutputStream outputStream = connection.getOutputStream();
            outputStream.write(bs);
            outputStream.flush();
            outputStream.close();
        }

        return connection.getInputStream();
    }

}

另一个是把IO流里的数据转换为String

public class IoUtils {

    public static String inputStreamToString(InputStream inputStream) throws IOException{
        int size =inputStream.available();
        byte[] bs =new byte[size];
        inputStream.read(bs);
        String message=new String(bs,"UTF-8");
        return message;
    }
}

而获取用户列表只需获取到ACCESS_TOKEN然后调用这两个方法就可以了。

InputStream inputStream = HttpUtils.connectHttp("https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID", "GET", null);
String m = IoUtils.inputStreamToString(inputStream);

没有错误的话m就是用户列表json数据包，然后自己再根据需求决定具体操作。这里不再讲述关注者数量超过10000时的调用过程，基本上差不多。

获取用户基本信息(UnionID机制)

说明

在关注者与公众号产生消息交互后，公众号可获得关注者的OpenID（加密后的微信号，每个用户对每个公众号的OpenID是唯一的。对于不同公众号，同一用户的openid不同）。公众号可通过本接口来根据OpenID获取用户基本信息，包括昵称、头像、性别、所在城市、语言和关注时间。

请注意，如果开发者有在多个公众号，或在公众号、移动应用之间统一用户帐号的需求，需要前往微信开放平台（open.weixin.qq.com）绑定公众号后，才可利用UnionID机制来满足上述需求。

UnionID机制说明

开发者可通过OpenID来获取用户基本信息。特别需要注意的是，如果开发者拥有多个移动应用、网站应用和公众帐号，可通过获取用户基本信息中的unionid来区分用户的唯一性，因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号，用户的unionid是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，unionid是相同的。

接口调用请求说明

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
openid	是	普通用户的标识，对当前公众号唯一
lang	否	返回国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语

关于返回这里就不再说明，有需要可以观看获取用户基本信息(UnionID机制)。

分析

这个接口与获取用户列表的访问方式一致也是使用GET方式访问，代码也大同小异，但是批量获取用户基本信息就不同了，批量获取用户基本信息接口是采用POST方式访问的，其实工具封装好后也是比较简单的。

具体实现

InputStream inputStream = HttpUtils.connectHttp("https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN", "GET", null);
String m = IoUtils.inputStreamToString(inputStream);

上述代码中&lang=zh_CN可以不需要，OPENID也就是获取用户列表中获取到的OPENID。

---

下面代码是批量获取用户基本信息的代码
JSON数据示例

{
    "user_list": [
        {
            "openid": "otvxTs4dckWG7imySrJd6jSi0CWE", 
            "lang": "zh-CN"
        }, 
        {
            "openid": "otvxTs_JZ6SEiP0imdhpi50fuSZg", 
            "lang": "zh-CN"
        }
    ]
}

String json = ""；
InputStream inputStream = HttpUtils.connectHttp("https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=ACCESS_TOKEN", "POST", json.getBytes("UTF-8"));
String m = IoUtils.inputStreamToString(inputStream);

设置用户备注名

接口调用请求说明

http请求方式: POST（请使用https协议）
https://api.weixin.qq.com/cgi-bin/user/info/updateremark?access_token=ACCESS_TOKEN
POST数据格式：JSON
POST数据例子：
{
“openid”:”oDF3iY9ffA-hqb2vVvbr7qxf6A0Q”,
“remark”:”pangzi”
}

参数说明

参数	是否必须	说明
access_token	调用接口凭证
openid	用户标识
remark	新的备注名，长度必须小于30字符

具体实现

请参考获取用户基本信息的批量获取用户基本信息。

---

如有错误，望留言，本人确认后会进行改正，谢谢。