自定义菜单创建接口
(以“=自定义菜单创建接口= 自定义菜单创建接口 ==URL== https://api.weibo.com/2/messages/menu/create.json ==HTTP请求方式== POST ==是否需要登...”为内容创建页面) |
|||
| 第23行： | 第23行： | ||
!width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|类型及范围 | !width="10%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|类型及范围 | ||
!width="75%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|说明 | !width="75%" style="text-align:center;font-weight:bolder;border:1px solid #cccccc"|说明 | ||
| − | + | {{api_args|access_token|false|string|在粉丝服务开发者模式中获取，或者OAuth授权后获得。}} | |
| − | {{api_args|access_token|false|string| | + | {{api_args|menus|string|需要创建的自定义菜单。必须为json做URLEncode后的字符串格式，具体内容格式详见注意事项。}} |
| − | {{api_args| | + | |
| − | + | ||
| − | + | ||
| − | + | ||
|} | |} | ||
==注意事项== | ==注意事项== | ||
| − | * | + | *参数menus的json示例，实际调用时需将以下json进行URLEncode： |
| − | * | + | **1，其中"button"数组中需为1~3个 |
| − | * | + | **2，其中"sub_button"数组中需为1~5个 |
| − | * | + | <pre class="brush:js"> |
| − | * | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | < | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
{ | { | ||
| − | " | + | "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字节 | ||
</pre> | </pre> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| 第170行： | 第84行： | ||
// 成功返回 | // 成功返回 | ||
{ | { | ||
| − | " | + | "result": true |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
} | } | ||
// 失败返回 | // 失败返回 | ||
{ | { | ||
| − | "request": "/2/messages/ | + | "request": "/2/messages/menu/create.json", |
"error_code": 264XX, | "error_code": 264XX, | ||
"error": "error message." | "error": "error message." | ||
2014年4月18日 (五) 07:40的版本
自定义菜单创建接口
自定义菜单创建接口
URL
https://api.weibo.com/2/messages/menu/create.json
HTTP请求方式
POST
是否需要登录
是
关于登录授权，参见 如何登录授权
接口请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | false | string | 在粉丝服务开发者模式中获取，或者OAuth授权后获得。 |
| menus | string | 需要创建的自定义菜单。必须为json做URLEncode后的字符串格式，具体内容格式详见注意事项。 | {{{4}}} |
注意事项
- 参数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."
}
