微信公众平台开发5-用户管理中常用接口调用实例及解析(含源码)

编程爱好者联盟 2017-03-09

微信公众平台开发-用户管理中常用接口调用实例及解析(含源码)作者: 孟祥磊-《微信公众平台开发实例教程》

掌握用户的第一步就是将已经关注的粉丝信息保存起来,这个时候就用到获取用户列表接口。公众号可通过本接口来获取帐号的关注者列表,关注者列表由一串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个数,最大值为10000data 列表数据,OPENID的列表next_openid 拉取列表的最后一个用户的OPENID

使用程序调用接口获取,代码:

<?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()函数获取返回的信息,处理后,进行打印,如图所示。

微信公众平台开发5-用户管理中常用接口调用实例及解析(含源码)

如果关注用户大于10000,需多次调用,只需在接口后增加&next_openid=NEXT_OPENID的参数,NEXT_OPENID会在前一次调用时返回该值,如:

$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数据包给公众号,如下所示:

{

   "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_CNheadimgurl 用户头像,最后一个数值代表正方形头像大小(有0、46、64、96、132数值可选,0代表640*640正方形头像),用户没有头像时该项为空。若用户更换头像,原有头像URL将失效。subscribe_time 用户关注时间,为时间戳。如果用户曾多次关注,则取最后关注时间unionid 只有在用户将公众号绑定到微信开放平台帐号后,才会出现该字段。remark 公众号运营者对粉丝的备注,公众号运营者可在微信公众平台用户管理界面对粉丝添加备注groupid 用户所在的分组ID(兼容旧的用户分组接口)tagid_list 用户被打上的标签ID列表

使用程序调用接口获取,代码:

<?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循环

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 />";

}

运行结果如图所示。

微信公众平台开发5-用户管理中常用接口调用实例及解析(含源码)

如果需要将用户信息保存到数据库,只需替换print_r($infoarr);为增加数据库的代码即可,如:

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);
}

相关推荐