微信公众平台自定义菜单接口API指南.docVIP

简介 2fg0f0c7b 微信营销 开发者获取使用凭证(如何获取凭证)后,可以使用该凭证对公众账号的自定义菜单进行创建、查询和删除等操作。自定义菜单接口可实现以下类型按钮: click(点击事件): 用户点击click类型按钮后,微信服务器会通过消息接口(event类型)推送点击事件给开发者,并且带上按钮中开发者填写的key值,开发者可以通过自定义的key值进行消息回复。创建自定义菜单后,由于微信端缓存,需要24小时微信端才会展现出来。建议测试时可以尝试取消关注公众账号后,再次关注,则可以看到创建后的效果。 菜单创建接口说明 通过POST一个特定结构体,实现在微信端创建自定义菜单。 请求说明 http请求方式:POSThttps://api.weixin.qq/cgi-bin/menu/create?aess_token=ACCESS_TOKEN请求示例 {button:[{type:click,name:今日歌曲,key:V1001_TODAY_MUSIC},{type:click,name:歌手简介,key:V1001_TODAY_SINGER},{name:菜单,sub_button:[{type:click,name:helloword,key:V1001_HELLO_WORLD},{type:click,name:赞一下我们,key:V1001_GOOD}]}]}创建后效果:参数说明 参数是否必须说明button是按钮数组,按钮个数应为1~3个sub_button否子按钮数组,按钮个数应为1~5个type是按钮类型,目前有click类型name是按钮描述,既按钮名字,不超过16个字节,子菜单不超过40个字节key类型为click必须按钮KEY值,用于消息接口(event类型)推送,不超过128字节返回说明 正确的Json返回结果: {errcode:0,errmsg:ok}错误的Json返回结果 {errcode:40018,errmsg:invalidbuttonnamesize}统一返回码说明 菜单查询 接口说明 查询当前使用的自定义菜单结构。请求说明 对应创建接口,正确的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:helloword,key:V1001_HELLO_WORLD,sub_button:[]},{type:click,name:赞一下我们,key:V1001_GOOD,sub_button:[]}]}]}}统一返回码说明 菜单删除 接口说明 取消当前使用的自定义菜单。 请求说明 对应创建接口,正确的Json返回结果:{errcode:0,errmsg:ok}统一返回码说明 请先确保公众账号已经拥有接口调用权限。 默认每个公众帐号都不能超过下面的频率限制。当超出调用接口频率限制,调用对应接口将会收到如下错误信息: {errcode:45009,errmsg:apifreqoutoflimit}接口调用频率限制 接口名称频率限制获取凭证接口200(次/天)自定义菜单创建接口100(次/天)自定义菜单查询接口1000(次/天)自定义菜单删除接口100(次/天)