微信公眾平臺開發(fā)模式自定義菜單接口API指南

?開發(fā)實(shí)現(xiàn)方法，請查看?

微信公眾平臺開發(fā)（58）自定義菜單

?

簡介

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

click（點(diǎn)擊事件）：

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

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

菜單創(chuàng)建

接口說明

通過POST一個特定結(jié)構(gòu)體，實(shí)現(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ù)說明

參數(shù)是否必須說明

button	是	按鈕數(shù)組，按鈕個數(shù)應(yīng)為1~3個
sub_button	否	子按鈕數(shù)組，按鈕個數(shù)應(yīng)為1~5個
type	是	按鈕類型，目前有click類型
name	是	按鈕描述，既按鈕名字，不超過16個字節(jié)，子菜單不超過40個字節(jié)
key	類型為click必須	按鈕KEY值，用于消息接口(event類型)推送，不超過128字節(jié)

返回說明

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

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

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

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

統(tǒng)一返回碼說明

菜單查詢

接口說明

查詢當(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":[]}]}]}}

統(tǒng)一返回碼說明

?

菜單刪除

接口說明

取消當(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"}

統(tǒng)一返回碼說明

?

請先確保公眾賬號已經(jīng)擁有接口調(diào)用權(quán)限。

默認(rèn)每個公眾帳號都不能超過下面的頻率限制。 當(dāng)超出調(diào)用接口頻率限制，調(diào)用對應(yīng)接口將會收到如下錯誤信息：

{"errcode":45009,"errmsg":"api freq out of limit"}

接口調(diào)用頻率限制

接口名稱頻率限制

獲取憑證接口	200（次/天）
自定義菜單創(chuàng)建接口	100（次/天）
自定義菜單查詢接口	1000（次/天）
自定義菜單刪除接口	100（次/天）

?

返回碼說明

返回碼說明

-1	系統(tǒng)繁忙
0	請求成功
40001	驗(yàn)證失敗
40002	不合法的憑證類型
40003	不合法的OpenID
40004	不合法的媒體文件類型
40005	不合法的文件類型
40006	不合法的文件大小
40007	不合法的媒體文件id
40008	不合法的消息類型
40009	不合法的圖片文件大小
40010	不合法的語音文件大小
40011	不合法的視頻文件大小
40012	不合法的縮略圖文件大小
40013	不合法的APPID
40014	不合法的access_token
40014	不合法的access_token
40015	不合法的菜單類型
40016	不合法的按鈕個數(shù)
40017	不合法的按鈕個數(shù)
40018	不合法的按鈕名字長度
40019	不合法的按鈕KEY長度
40020	不合法的按鈕URL長度
40021	不合法的菜單版本號
40022	不合法的子菜單級數(shù)
40023	不合法的子菜單按鈕個數(shù)
40024	不合法的子菜單按鈕類型
40025	不合法的子菜單按鈕名字長度
40026	不合法的子菜單按鈕KEY長度
40027	不合法的子菜單按鈕URL長度
40028	不合法的自定義菜單使用用戶
41001	缺少access_token參數(shù)
41002	缺少appid參數(shù)
41003	缺少refresh_token參數(shù)
41004	缺少secret參數(shù)
41005	缺少多媒體文件數(shù)據(jù)
41006	缺少media_id參數(shù)
41007	缺少子菜單數(shù)據(jù)
42001	access_token超時
43001	需要GET請求
43002	需要POST請求
43003	需要HTTPS請求
44001	多媒體文件為空
44002	POST的數(shù)據(jù)包為空
44003	圖文消息內(nèi)容為空
45001	多媒體文件大小超過限制
45002	消息內(nèi)容超過限制
45003	標(biāo)題字段超過限制
45004	描述字段超過限制
45005	鏈接字段超過限制
45006	圖片鏈接字段超過限制
45007	語音播放時間超過限制
45008	圖文消息超過限制
45009	接口調(diào)用超過限制
45010	創(chuàng)建菜單個數(shù)超過限制
46001	不存在媒體數(shù)據(jù)
46002	不存在的菜單版本
46003	不存在的菜單數(shù)據(jù)
47001	解析JSON/XML內(nèi)容錯誤

?

源代碼：

微信公眾平臺消息接口開發(fā)（9）自定義菜單

?

歡迎關(guān)注方倍工作室微信，了解我們及行業(yè)的最新動態(tài)

轉(zhuǎn)載于:https://www.cnblogs.com/txw1958/archive/2013/03/24/weixin-menu-if-guide.html

總結(jié)

以上是生活随笔為你收集整理的微信公众平台自定义菜单接口API指南的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。