2014年6月3日 (二) 21:11的版本

自定义菜单创建接口

自定义菜单创建接口

URL

https://m.api.weibo.com/2/messages/menu/create.json

HTTP请求方式

POST

是否需要登录

是
关于登录授权，参见 如何登录授权

接口请求参数

注意事项

• 参数menus的json示例，实际调用时需将以下json进行URLEncode：
  • 1，其中"button"数组中需为1~3个
  • 2，其中"sub_button"数组中需为1~5个

{
    "button": [
        {
            "type": "click",
            "name": "获取优惠券",
            "key": "get_groupon"
        },
        {
            "type": "click",
            "name": "查询客服电话",
            "key": "I_need_your_phone"
        },
        {
            "name": "菜单",
            "sub_button": [
                {
                    "type": "view",
                    "name": "网上4S店",
                    "url": "http://apps.weibo.com/1838358847/8rYu1uHD"
                },
                {
                    "type": "view",
                    "name": "砍价团",
                    "url": "http://apps.weibo.com/1838358847/8s1i6v74"
                },
                {
                    "type": "click",
                    "name": "么么哒",
                    "key": "memeda"
                }
            ]
        }
    ]
}

参数说明：
1，button 必填 一级菜单数组，个数应为1~3个
2，sub_button 选填 二级菜单数组，个数应为1~5个
3，type 选填 （与二级菜单sub_button同级是可不填）菜单的响应动作类型，目前有click、view两种类型
4，name 必填 菜单标题，不超过16个字节，子菜单不超过40个字节
5，key 选填 type为click时必填，菜单KEY值，用于消息接口推送，不超过128字节
6，url 选填 type为view时必填，网页链接，用户点击菜单可打开链接，不超过256字节

返回结果

// 成功返回
{
    "result": true
}

// 失败返回
{
    "request": "/2/messages/menu/create.json",
    "error_code": 264XX,
    "error": "error message."
}