PHP7.0微信公众平台开发3: API接口的调用代码模板

• 1. API接口的声明
• 2. API接口的调用代码模板

---

1. API接口的声明

在微信公众平台开发者文档中（https://mp.weixin.qq.com/wiki），定义了很多的API接口可供开发者使用。

• 1）接口调用请求说明

微信所定义的数据格式有两种:POST和GET。

‘POST’请求方式：（如群发接口）

‘GET’请求方式：（如获取用户列表）

接口声明用于调用https_request($url,$type,$res,$arr)方法时（实现代码见上一篇），参数列表中的$type等于“post”还是“get”, “post”是发送数据（如向用户发送消息），“get”是获取数据（如获取关注该订阅号的用户ID列表）；参数列表中的$url就是该声明中的URL。

• 2) POST数据说明

由于POST请求方式需要向用户发送数据，因此这里定义了发送数据的格式。微信所定义的数据格式有两种：JSON和XML。

‘JSON’数据格式：（如群发图文消息接口）

‘XML’数据格式：（如关注/取消关注事件接口）

不管哪种数据格式，在调用的时候一般先放入一个数组array中，然后再将array传入http_request()函数中。

POST数据说明用于调用https_request($url,$type,$res,$arr)方法时（实现代码见上一篇），若$type=’post’, 参数列表中的$arr就是数组array。

若$type=’get’, 参数列表中的$arr等于空(”)。

• 3） 返回数据格式

对于返回数据，一般只为JSON格式：（如群发接口）

返回数据说明用于调用https_request($url,$type,$res,$arr)方法时（实现代码见上一篇），参数列表中的$res的格式，一般为‘json’。

2. API接口的调用代码模板

调用任何微信API接口时，php代码都是大同小异，格式和顺序都差不多，总结如下：

对于post请求：

public function 函数名（）{    $access_token = $this->getWxAccessToken();    //若已在构造函数里写了，这里就不用再写了    $url = "https://api.weixin.qq.com/cgi-bin/。。。。。。。。。。?access_token=".$access_token    //若上一行在构造函数里写了，注意这里就为$this->access_token;    $array = array(根据JSON或者XML的POST请求数据格式的声明写数据内容);    //注意,里面赋值不用"="，而是用"=>"    $postJson = json_encode($array);    $res = $this->https_request($url,'post','json',$postJson);    var_dump($res['一级目录']['二级目录']);    //输出筛选后的结果，若只写$res则为输出全部结果}

对于get请求：

public function 函数名（）{    $access_token = $this->getWxAccessToken();    //若已在构造函数里写了，这里就不用再写了    $url = "https://api.weixin.qq.com/cgi-bin/。。。。。。。。。。?access_token=".$access_token    //若上一行在构造函数里写了，注意这里就为$this->access_token;    $res = $this->https_request($url,'get','json','');    //注意最后一个参数为空''    var_dump($res['一级目录']['二级目录']);    //输出筛选后的结果，若只写$res则为输出全部结果}

从下一篇开始，会陆续写几个调用API接口的实例，在那里会看到如何实际使用这个模板。