在线客服

全球共有40多个国家和地区5000多个平台,200万+商户使用

我要试用
文档中心 > 开放平台

自定义菜单

更新时间:2016/10/11

(一)创建自定义菜单

创建自定义菜单的流程分为两步:
1、准备自定义菜单的json字符串
2、提交菜单

第一步:准备自定义菜单的json字符串

字符串的字段为menus
{
     "button":[
     {
          "type":"click",
          "name":"今日歌曲",
          "key":"V1001_TODAY_MUSIC"
      },
      {
           "name":"菜单",
           "sub_button":[
           {
               "type":"view",
               "name":"搜索",
               "url":"http://www.soso.com/"
            },
            {
               "type":"view",
               "name":"视频",
               "url":"http://v.qq.com/"
            },
            {
               "type":"click",
               "name":"赞一下我们",
               "key":"V1001_GOOD"
            }]
       }]
 }

 

参数说明

参数 是否必须 说明
button 一级菜单数组,个数应为1~3个
sub_button 二级菜单数组,个数应为1~5个
type 菜单的响应动作类型
name 菜单标题,不超过16个字节,子菜单不超过40个字节
key click等点击类型必须 菜单KEY值,用于消息接口推送,不超过128字节
url view类型必须 网页链接,用户点击菜单可打开链接,不超过256字节
media_id media_id类型和view_limited类型必须 调用新增永久素材接口返回的合法media_id

第二步:提交菜单

http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=createDiyMenu

参数说明

参数 是否必须 说明
ConnectKey 对接key
access_token 是公众号的全局唯一票据
menus 上一步的json字符串

返回说明

正常情况下,会返回下述JSON数据包:
{"errcode":0,"errmsg":"ok"}
错误时会返回错误码等信息,JSON数据包示例如下(示例为无效菜单名长度):
{"errcode":40018,"errmsg":"无效的菜单名长度"}

 

(二)查询自定义菜单

请求说明

http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=selectDiyMenu

参数说明

参数 是否必须 说明
ConnectKey 对接key
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":"view","name":"搜索","url":"http://www.soso.com/","sub_button":[]},{"type":"view","name":"视频","url":"http://v.qq.com/","sub_button":[]},{"type":"click","name":"赞一下我们","key":"V1001_GOOD","sub_button":[]}]}]}}

 

(三)删除自定义菜单

请求说明

http请求方式: POST,http://xxx.xxx.xxx/ 为自己的网站域名
http://xxx.xxx.xxx/index.php?g=Home&m=ConnectApi&a=deleteDiyMenu

参数说明

参数 是否必须 说明
ConnectKey 对接key
access_token 是公众号的全局唯一票据

返回说明

对应创建接口,正确的Json返回结果:
{"errcode":0,"errmsg":"ok"}


 

附:返回码说明,(其他见微信)


返回码 说明
40013 无效的appid
40029 无效的code
41001 缺少access_token参数
41009 缺少openid
44439 无效的scope
44440 无效的跳转地址
44441 对接key不能为空!
44442 数据来源不合法!
44443 数据被篡改了
44444 对接用户不存在,非法用户
50001 用户未授权该api
   

合肥彼岸互联信息技术有限公司  合肥市高新区亚夏汽车大厦17楼
工信部备案号: 皖B2-20150071-4  增值电信业务经营许可证:皖B2-20150071-4 安全联盟认证
友情链接: o2o生活通系统 微分销系统 兄弟连教育 火车采集器 加速乐 站长团购 后盾IT教育 php A5创业网 微信H5游戏营销