掌握用户的第一步就是将已经关注的粉丝信息保存起来,这个时候就用到获取用户列表接口。公众号可通过本接口来获取帐号的关注者列表,关注者列表由一串OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成。一次拉取调用最多拉取10000个关注者的OpenID,可以通过多次拉取的方式来满足需求。
一、 获取微信关注用户列表接口调用实例
接口说明
http请求方式:GET
接口调用地址:
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 |
使用程序调用接口获取,代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
<?php /* *获取微信关注用户列表OpenID */ require ( 'wei_function.php' ); $appid = "wx78478e595939c538" ; $secret = "5540e8ccab4f71dfad752f73cfb85780" ; $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" . $appid . "&secret=" . $secret . "" ; $output =getdata( $url ); $tokenarr =( array )json_decode( $output ); $token = $tokenarr [ 'access_token' ]; //获取关注用户列表接口 $userurl = "https://api.weixin.qq.com/cgi-bin/user/get?access_token=" . $token . "" ; //通过getdata进行接口调用 $userarr =( array )json_decode(getdata( $userurl )); //将返回信息进行处理并输出 $useropenidarr =( array ) $userarr [ 'data' ]; print_r( $useropenidarr ); ?> |
代码解析
require('wei_function.php');包含wei_function.php,该函数文件可以购买《微信公众平台开发实例教程》,在该书中第95页有详细讲解。
与微信公众平台开发3-微信服务器IP接口实例(含源码)的获取微信服务器IP一样,获取到access_token后,替换
$userurl="https://api.weixin.qq.com/cgi-bin/user/get?access_token=".$token."";
中的access_token参数,并通过getdata()函数获取返回的信息,处理后,进行打印,如图所示。
如果关注用户大于10000,需多次调用,只需在接口后增加&next_openid=NEXT_OPENID的参数,NEXT_OPENID会在前一次调用时返回该值,如:
1
|
$userurl = "https://api.weixin.qq.com/cgi-bin/user/get?access_token=" . $token . "&next_openid=NEXT_OPENID" ; |
二、用户基本信息接口(UnionID机制)调用实例
在通过获取关注用户列表接口获取到用户的OpenID后,可通过该参数并调用获取用户基本信息(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 英语 |
返回说明:
正常情况下,微信会返回JSON数据包给公众号,如下所示:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
{ "subscribe" : 1, "openid" : "o6_bmjrPTlm6_2sgVt7hMZOPfL2M" , "nickname" : "Band" , "sex" : 1, "language" : "zh_CN" , "city" : "广州" , "province" : "广东" , "country" : "中国" , "headimgurl" : "http: //wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4 eMsv84eavHiaiceqxibJxCfHe/0", "subscribe_time" : 1382694957, "unionid" : " o6_bmasdasdsad6_2sgVt7hMZOPfL" "remark" : "" , "groupid" : 0, "tagid_list" :[128,2] } |
返回信息参数说明,如表所示:
参数 |
说明 |
subscribe |
用户是否订阅该公众号标识,值为0时,代表此用户没有关注该公众号,拉取不到其余信息。 |
openid |
用户的标识,对当前公众号唯一 |
nickname |
用户的昵称 |
sex |
用户的性别,值为1时是男性,值为2时是女性,值为0时是未知 |
city |
用户所在城市 |
country |
用户所在国家 |
province |
用户所在省份 |
language |
用户的语言,简体中文为zh_CN |
headimgurl |
用户头像,最后一个数值代表正方形头像大小(有0、46、64、96、132数值可选,0代表640*640正方形头像),用户没有头像时该项为空。若用户更换头像,原有头像URL将失效。 |
subscribe_time |
用户关注时间,为时间戳。如果用户曾多次关注,则取最后关注时间 |
unionid |
只有在用户将公众号绑定到微信开放平台帐号后,才会出现该字段。 |
remark |
公众号运营者对粉丝的备注,公众号运营者可在微信公众平台用户管理界面对粉丝添加备注 |
groupid |
用户所在的分组ID(兼容旧的用户分组接口) |
tagid_list |
用户被打上的标签ID列表 |
使用程序调用接口获取,代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
|
<?php /* *获取微信关注用户基本信息 */ require ( 'wei_function.php' ); $appid = "wx78478e595939c538" ; $secret = "5540e8ccab4f71dfad752f73cfb85780" ; $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" . $appid . "&secret=" . $secret . "" ; $output =getdata( $url ); $tokenarr =( array )json_decode( $output ); $token = $tokenarr [ 'access_token' ]; //获取关注用户列表接口 $userurl = "https://api.weixin.qq.com/cgi-bin/user/get?access_token=" . $token . "" ; //通过getdata进行接口调用 $userarr =( array )json_decode(getdata( $userurl )); //将返回信息进行处理并输出 $useropenidarr =( array ) $userarr [ 'data' ]; foreach ( $useropenidarr [ 'openid' ] as $value ) { //循环获取用户基本信息 $infourl = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=" . $token . "&openid=" . $value . "&lang=zh_CN" ; $infoarr =( array )json_decode(getdata( $infourl )); print_r( $infoarr ); echo "<br />" ; } ?> |
代码解析
require('wei_function.php');包含wei_function.php,该函数文件可以购买《微信公众平台开发实例教程》,在该书中第95页有详细讲解。
获取到用户OpenID列表后,根据每条OpenID获取用户基本信息,这里用到foreach循环
1
2
3
4
5
6
7
|
foreach ( $useropenidarr [ 'openid' ] as $value ) { //循环获取用户基本信息 $infourl = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=" . $token . "&openid=" . $value . "&lang=zh_CN" ; $infoarr =( array )json_decode(getdata( $infourl )); print_r( $infoarr ); echo "<br />" ; } |
运行结果如图所示。
如果需要将用户信息保存到数据库,只需替换print_r($infoarr);为增加数据库的代码即可,如:
1
2
3
4
5
6
7
8
9
|
foreach ( $useropenidarr [ 'openid' ] as $value ) { //循环获取用户基本信息 $infourl = "https://api.weixin.qq.com/cgi-bin/user/info?access_token=" . $token . "&openid=" . $value . "&lang=zh_CN" ; $infoarr =( array )json_decode(getdata( $infourl )); //将用户信息增加到数据库 $sql =”insert into userinfo(`nickname`,`sex`,`city`) values (‘”. $infoarr [‘nickname '].”' , '”.$infoarr[' sex '].”' , '”.$infoarr[' city '].”' )”; mysql_query( $sql ); } |
以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,同时也希望多多支持服务器之家!
原文链接:http://www.cnblogs.com/mxlbook/p/6525149.html