簡介

開發(fā)者獲取使用憑證后，可以使用該憑證對公眾賬號的自定義菜單進行創(chuàng)建、查詢和刪除等操作。 自定義菜單接口可實現(xiàn)以下類型按鈕：

click（點擊事件）：

用戶點擊click類型按鈕后，微信服務(wù)器會通過消息接口(event類型)推送點擊事件給開發(fā)者，并且?guī)习粹o中開發(fā)者填寫的key值，開發(fā)者可以通過自定義的key值進行消息回復(fù)。

創(chuàng)建自定義菜單后，由于微信客戶端緩存，需要24小時微信客戶端才會展現(xiàn)出來。建議測試時可以嘗試取消關(guān)注公眾賬號后，再次關(guān)注，則可以看到創(chuàng)建后的效果。

菜單創(chuàng)建

接口說明

通過POST一個特定結(jié)構(gòu)體，實現(xiàn)在微信客戶端創(chuàng)建自定義菜單。

請求說明

http請求方式：POST
https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN

請求示例

 {
     "button":[
     {	
          "type":"click",
          "name":"今日歌曲",
          "key":"V1001_TODAY_MUSIC"
      },
      {
           "type":"click",
           "name":"歌手簡介",
           "key":"V1001_TODAY_SINGER"
      },
      {
           "name":"菜單",
           "sub_button":[
            {
               "type":"click",
               "name":"hello word",
               "key":"V1001_HELLO_WORLD"
            },
            {
               "type":"click",
               "name":"贊一下我們",
               "key":"V1001_GOOD"
            }]
       }]
 }

創(chuàng)建后效果:

參數(shù)說明

返回說明

正確的Json返回結(jié)果:

{"errcode":0,"errmsg":"ok"}

錯誤的Json返回結(jié)果

{"errcode":40018,"errmsg":"invalid button name size"}
 

菜單查詢

接口說明

查詢當(dāng)前使用的自定義菜單結(jié)構(gòu)。

請求說明

http請求方式：GET
https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN

返回說明

對應(yīng)創(chuàng)建接口，正確的Json返回結(jié)果:
{"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":[]}]}]}}

菜單刪除

接口說明

取消當(dāng)前使用的自定義菜單。

請求說明

http請求方式：GET
https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN

返回說明

對應(yīng)創(chuàng)建接口，正確的Json返回結(jié)果:
{"errcode":0,"errmsg":"ok"}