創建菜單的接口如下。
https:// api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN
創建菜單時,需要將菜單內容組織成如下結構,以POST的方式向微信服務器提交。
{ "button": [ { "name": "掃碼", "sub_button": [ { "type": "scancode_waitmsg", "name": "掃碼帶提示", "key": "rselfmenu_0_0" }, { "type": "scancode_push", "name": "掃碼推事件", "key": "rselfmenu_0_1" } ] }, { "name": "發圖", "sub_button": [ { "type": "pic_sysphoto", "name": "系統拍照發圖", "key": "rselfmenu_1_0" }, { "type": "pic_photo_or_album", "name": "拍照或者相冊發圖", "key": "rselfmenu_1_1" }, { "type": "pic_weixin", "name": "微信相冊發圖", "key": "rselfmenu_1_2" } ] }, { "name": "其他", "sub_button": [ { "name": "發送位置", "type": "location_select", "key": "rselfmenu_2_0" }, { "type": "click", "name": "今日歌曲", "key": "V1001_TODAY_MUSIC" }, { "type": "view", "name": "搜索", "url": "http:// www.soso.com/" } ] } ] }
自定義菜單內容的參數說明如表5-3所示。
表5-3 自定義菜單參數說明
為微信公眾號創建自定義菜單的代碼實現如下。
$jsonmenu = '{ "button": [ { "name": "掃碼", "sub_button": [ { "type": "scancode_waitmsg", "name": "掃碼帶提示", "key": "rselfmenu_0_0" }, { "type": "scancode_push", "name": "掃碼推事件", "key": "rselfmenu_0_1" } ] }, { "name": "發圖", "sub_button": [ { "type": "pic_sysphoto", "name": "系統拍照發圖", "key": "rselfmenu_1_0" }, { "type": "pic_photo_or_album", "name": "拍照或者相冊發圖", "key": "rselfmenu_1_1" }, { "type": "pic_weixin", "name": "微信相冊發圖", "key": "rselfmenu_1_2" } ] }, { "name": "其他", "sub_button": [ { "name": "發送位置", "type": "location_select", "key": "rselfmenu_2_0" }, { "type": "click", "name": "今日歌曲", "key": "V1001_TODAY_MUSIC" }, { "type": "view", "name": "搜索", "url": "http:// www.soso.com/" } ] } ] } '; $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; }
正確時返回的JSON數據包如下。
{"errcode":0,"errmsg":"ok"}
錯誤時返回的JSON數據包如下(示例為無效菜單名長度)。
{"errcode":40018,"errmsg":"invalid button name size"}
其中,errcode為全局返回碼。