怎麼呼叫微信高階介面
微信高階介面與微信普通介面的差異
後台伺服器可以呼叫微信的接口與微信用戶進行訊息的通信,這樣的行為就是在調用微信的接口,這些接口是基礎接口,你不需要任何付費行為或者身份認證行為就可以調用。但是有一些高級接口,你的微信公眾號必須達到一定的權限如通過微信認證才能調用自定義菜單、微信支付等高級功能。
不過微信公眾帳號的測試號碼系統可以套用這些高階介面(微信支付等涉及交易的介面除外)。
微信高級接口的呼叫
微信高級接口的呼叫需要先呼叫一個token_access接口,只有先呼叫這個接口才能呼叫其它高級接口。
如下:連通高階介面示意圖
#呼叫token_access需要用到appID和appsecreset(在微信公眾號平台開發(一)中已經講述這兩者的由來)
呼叫程式碼如下
<?php $appid = "wxbad0b4x543aa0b5e"; $appsecret = "ed222a84da15cd24c4bdfa5d9adbabf2"; $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$appid&secret=$appsecret"; //下面是一个cURL会话过程,通过这个会话可以返回一段字符串{"access_token":"NU7Kr6v9L9TQaqm5NE3OTPctTZx797Wxw4Snd2WL2HHBqLCiXlDVOw2l-Se0I-WmOLLniAYLAwzhbYhXNjb"} 这就是我们要获得的Access Token了。在调用高级功能接口的时候就靠它。这个过程用的时候直接引用就好,不需要深究,这个cURL系统相关函数有点多而且复杂。 $ch = curl_init();//初始化 curl_setopt($ch, CURLOPT_URL, $url);//与url建立对话 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); //进行配置 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); //进行配置 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);//进行配置 $output = curl_exec($ch);//执行对话,获取接口数据Access Token curl_close($ch);//关闭会话 $jsoninfo = json_decode($output, true);//解码接口数据,将json格式字符串转换成php变量或数组。默认是变量,加true后是数组。 $access_token = $jsoninfo["access_token"]; ?>
呼叫微信高階介面
1)、呼叫自訂選單功能
//创建一个自定义菜单的json字符串 $jsonmenu = '{ "button":[ { "name":"关于我们", "sub_button":[ { "type":"click", "name":"公司简介", "key":"公司简介" }, { "type":"click", "name":"社会责任", "key":"社会责任" }, { "type":"click", "name":"联系我们", "key":"联系我们" }] }, { "name":"产品服务", "sub_button":[ { "type":"click", "name":"微信平台", "key":"微信平台" }, { "type":"click", "name":"微博应用", "key":"微博应用" }, { "type":"click", "name":"手机网站", "key":"手机网站" }] }, { "name":"技术支持", "sub_button":[ { "type":"click", "name":"文档下载", "key":"文档下载" }, { "type":"click", "name":"技术社区", "key":"技术社区" }, { "type":"click", "name":"服务热线", "key":"服务热线" }] }] }'; $url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=".$access_token;//接口地址 $result = https_request($url, $jsonmenu);//与接口建立会话 var_dump($result); function https_request($url,$data = null){ $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE); if (!empty($data)){ curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, $data); } curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); $output = curl_exec($curl); curl_close($curl); return $output; } //把这段代码加入到上面的调用Access Token接口的代码中就可以实现在微信公众号界面添加菜单的功能。
當我們為微信公眾號新增選單後怎麼樣設定點擊選單時會出現對應的效果呢?
這裡涉及到另一種xml類型的資料傳遞:
<xml> <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName> <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName> <CreateTime>1392297442</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[CLICK]]></Event> <EventKey><![CDATA[公司简介]]></EventKey> </xml> //上面是点击click菜单的数据传递类型,数据会发送给后台服务器,然后服务器做出响应。
選單類型有多種,xml類型差別,詳細情況可以在微信公眾號平台上查看對應文件。
*這裡要說明的是只要你有微信公眾號的appID和appsecret,在任何伺服器空間運行這段php程式碼都可以進入微信伺服器呼叫對應功能,不一定要在進行了token驗證的伺服器下運作。 token驗證是為了後台伺服器進行判斷資料來源是否是來自微信伺服器,與呼叫微信伺服器的高階介面並沒有多大的關聯。
php檔案一定要在伺服器運行才會產生效果。
其它高階介面的呼叫都同調用自訂選單一樣。
2)、呼叫客服介面
當微信用戶主動發送訊息給微信公眾帳號的時候(包括發送訊息、點擊自訂選單click事件、訂閱事件、掃描二維碼、支付成功事件)微信會把訊息資料推給開發者。開發者在一段時間內可以呼叫客服介面訊息,透過post一個JSON封包來傳送訊息給使用者。
程式碼如下:
$access_token = "nFX6GFsspSLBKJLgMQ3kj1YM8_FchRE7vE2ZOIlmfiCOQntZKnBwuOen2GCBpFHBYS4QLGX9fGoVfA36tftME2sRiYsKPzgGQKU-ygU7x8cgy_1tlQ4n1mhSumwQEGy6PK6rdTdo8O8GROuGE3Hiag"; $openid = "o7Lp5t6n59DeX3U0C7Kric9qEx-Q";//微信用户都有一个openID
下圖所示即為openID的取得方式。
$data = '{ "touser":"'.$openid.'", "msgtype":"text", "text": { "content":"Hello World" } }';//通过基础消息接口发送的数据是XML格式的,但是调用客服接口发送的数据是json数据格式,更易传输。 $url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=".$access_token; $result = https_request($url,$data); var_dump($result); function https_request($url,$data) { $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, $data); curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); $result = curl_exec($curl); if (curl_errno($curl)) { return 'Errno'.curl_error($curl); } curl_close($curl); return $result; }
客服介面發送圖文訊息、音樂訊息、視訊訊息具體格式請參考微信公眾平台上的開發幫助文件。
客服介面可以和訊息介面混合使用。
這裡大家可能不明白既然可以直接透過被動回應訊息的介面發送xml資料給用戶,為什麼還需要這樣一個客服介面?可以這樣理解,被動回應訊息是一次性的只能回覆一次相同的訊息。如你向一個音樂平台輸入一個歌星名稱,透過被動回應方式發送的訊息永遠只會回覆你一首相同的歌。但透過客服介面方式可以每次回覆不同的 歌曲,這涉及到MySQL資料庫。
再簡單一點,一個查看快遞包含地址的微信公眾平台。你每次輸入同一個訂單編號,後台卻能夠回覆訂單每次所在的位置(針對同樣的文字卻可以做出不同的回應)就像是人工回覆一樣,這就是客服介面 。
3)、產生二維碼介面
二維碼類型分兩種,分別是臨時二維碼eh 和永久二維碼,前者與過期時間,最長是1800s 。
產生二維碼你需要呼叫3個接口,
第一個是access_token
第二個是產生ticket接口
第三個是透過第二個接口產生的ticket來換取二維碼圖片。
$access_token = " xDx0pD_ZvXkHM3oeu5oGjDt1_9HxlA-9g0vtR6MZ-v4r7MpvZYC4ee4OxN97Lr4irkPKE94tzBUhpZG_OvqAC3D3XaWJIGIn0eeIZnfaofO1C3LNzGphd_rEv3pIimsW9lO-4FOw6D44T3sNsQ5yXQ";//假定获取的ACCESS TOKEN为这段代码。 //临时二维码 $qrcode = '{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 10000}}}'; //永久二维码 $qrcode = '{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 1000}}}'; $url = "https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=$access_token";//创建ticket接口 $result = https_request($url,$qrcode); $jsoninfo = json_decode($result, true); $ticket = $jsoninfo["ticket"]; function https_request($url, $data = null){ $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE); if (!empty($data)){ curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, $data); } curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); $output = curl_exec($curl); curl_close($curl); return $output; } $ticket = "gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA==";//获取ticket的字符串 $url = "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=".urlencode($ticket);//ticket对面二维码图片代码。 $imageInfo = downloadWeixinFile($url); $filename = "qrcode.jpg"; $local_file = fopen($filename, 'w'); if (false !== $local_file){ if (false !== fwrite($local_file, $imageInfo["body"])) { fclose($local_file); } } function downloadWeixinFile($url) { $ch = curl_init($url); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_NOBODY, 0); //只取body头 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $package = curl_exec($ch); $httpinfo = curl_getinfo($ch); curl_close($ch); return array_merge(array('body' => $package), array('header' => $httpinfo)); }
在伺服器空間運行這段程式碼,瀏覽器會產生一張二維碼圖片。
取得非微信功能接口,例如取得交通資訊、天氣預報。
以上是php微信自訂選單介面、客服介面、二維碼使用程式碼詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!