自定义菜单创建接口
自定义菜单创建接口
自定义菜单创建接口
URL
https://m.api.weibo.com/2/messages/menu/create.json
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
接口请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 在粉丝服务开发者模式中获取,或者OAuth授权后获得。 |
menus | true | string | 需要创建的自定义菜单。必须为json做URLEncode后的字符串格式,具体内容格式详见注意事项。 |
注意事项
- 参数menus的json示例,实际调用时需将以下json进行URLEncode:
- 1,其中"button"数组中需为1~3个
- 2,其中"sub_button"数组中需为1~5个
{ "button": [ { "type": "click", "name": "今日歌曲", "key": "V1001_TODAY_MUSIC" }, { "type": "click", "name": "歌手简介", "key": "V1001_TODAY_SINGER" }, { "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" } ] } ] } 参数说明: 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." }