20.5 自定义菜单

20.5.1　创建菜单

目前自定义菜单最多包含3个一级菜单，每个一级菜单最多包含5个二级菜单。一级菜单最多设置4个汉字，二级菜单最多设置7个汉字，多出来的部分将会以“...”代替。

自定义菜单接口可实现多种类型的按钮，如表20-20所示。

表20-20　菜单按钮类型参数说明

创建菜单的接口如下。

https:// qyapi.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN&agentid=AGENTID
  

创建菜单时，POST数据示例如下。

{
    "button":[
        {
            "type":"click",
            "name":"今日歌曲",
            "key":"V1001_TODAY_MUSIC"
        },
        {
            "name":"菜单",
            "sub_button":[
                {
                    "type":"view",
                    "name":"搜索",
                    "url":"http:// www.soso.com/"
                },
                {
                    "type":"click",
                    "name":"赞一下我们",
                    "key":"V1001_GOOD"
                }
            ]
        }
    ]
}
  

上述数据的参数说明如表20-21所示。

表20-21　创建菜单接口的参数说明

正确提交时，返回的数据示例如下。

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