簡介
開發人員擷取使用憑證(如何擷取憑證)後,可以使用該憑證對公眾帳號的自訂菜單進行建立、查詢和刪除等操作。 自訂菜單介面可實現以下類型按鈕:
click(點擊事件):使用者點擊click類型按鈕後,伺服器會通過訊息介面(event類型)推送點擊事件給開發人員,並且帶上按鈕中開發人員填寫的key值,開發人員可以通過自訂的key值進行訊息回複。view(訪問網頁):使用者點擊view類型按鈕後,會直接跳轉到開發人員指定的url中。
建立自訂菜單後,由於用戶端緩衝,需要24小時用戶端才會展現出來。建議測試時可以嘗試取消追蹤公眾帳號後,再次關注,則可以看到建立後的效果。
菜單建立
介面說明
通過POST一個特定結構體,實現在用戶端建立自訂菜單。
請求說明
http請求方式:POSThttps://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN
請求樣本
{ "button":[ { "type":"click", "name":"今日歌曲", "key":"V1001_TODAY_MUSIC" }, { "type":"view", "name":"歌手簡介", "url":"http://www.bkjia.com/" }, { "name":"菜單", "sub_button":[ { "type":"click", "name":"hello word", "key":"V1001_HELLO_WORLD" }, { "type":"click", "name":"贊一下我們", "key":"V1001_GOOD" }] }] }
建立後效果:
參數說明
| 參數 |
是否必須 |
說明 |
| button |
是 |
按鈕數組,按鈕個數應為2~3個 |
| sub_button |
否 |
子按鈕數組,按鈕個數應為2~5個 |
| type |
是 |
按鈕類型,目前有click類型 |
| name |
是 |
按鈕描述,既按鈕名字,不超過16個位元組,子功能表不超過40個位元組 |
| key |
類型為click必須 |
按鈕KEY值,用於訊息介面(event類型)推送,不超過128位元組 |
返回說明
正確的Json返回結果:
{"errcode":0,"errmsg":"ok"}
錯誤的Json返回結果
{"errcode":40018,"errmsg":"invalid button name size"}
統一返回碼說明
菜單查詢
介面說明
查詢當前使用的自訂菜單結構。
請求說明
http請求方式:GEThttps://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN
返回說明
對應建立介面,正確的Json返回結果:{"menu":{"button":[{"type":"click","name":"今日歌曲","key":"V1001_TODAY_MUSIC","sub_button":[]},{"type":"click","name":"歌手簡介","key":"V1001_TODAY_SINGER","sub_button":[]},{"name":"菜單","sub_button":[{"type":"click","name":"hello word","key":"V1001_HELLO_WORLD","sub_button":[]},{"type":"click","name":"贊一下我們","key":"V1001_GOOD","sub_button":[]}]}]}}
統一返回碼說明
菜單刪除
介面說明
取消當前使用的自訂菜單。
請求說明
http請求方式:GEThttps://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN
返回說明
對應建立介面,正確的Json返回結果:{"errcode":0,"errmsg":"ok"}
http://www.bkjia.com/PHPjc/445640.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/445640.htmlTechArticle簡介 開發人員擷取使用憑證(如何擷取憑證)後,可以使用該憑證對公眾帳號的自訂菜單進行建立、查詢和刪除等操作。 自訂菜單介面...