更新时间:2024-01-16 GMT+08:00
分享

修改智能信息服务号菜单

功能介绍

支持用户修改所属企业的指定菜单。

URI

PUT /v1/aim-sa/menus/{menu_id}

表1 路径参数

参数

是否必选

参数类型

描述

menu_id

String

菜单ID。

最小长度:1

最大长度:32

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

menu

Menus object

菜单配置信息。

change_reason

String

修改原因。

最小长度:1

最大长度:1000

表4 Menus

参数

是否必选

参数类型

描述

menu_items

Array of MenuItem objects

各子菜单项配置。

数组长度:0 - 3

表5 MenuItem

参数

是否必选

参数类型

描述

name

String

子菜单名称。

  1. 一级菜单名长度和菜单数量有关,具体约束为:

    • 当菜单数量为1个时,菜单名长度范围在1-24个字符。

    • 当菜单数量为2个时,菜单名长度范围在1-12个字符。

    • 当菜单数量为3个时,菜单名长度范围在1-8个字符。

  2. 二级菜单名长度范围恒为1-16个字符。

说明:

以上字符区分中英文,一个中文占2个字符,字母和数字占1个字符,且同时生效的一组菜单内名称不能重复。

action_type

String

菜单动作类型。

  • OPEN_SUBMENU:打开子菜单

  • OPEN_URL:打开URL

  • CALLING:拨打电话

  • OPEN_APP:打开APP

  • OPEN_QUICK:打开快应用

最小长度:0

最大长度:30

content

String

对应值类型。对应不同action_type值,content含义如下:

  • action_type=OPEN_SUBMENU:不填

  • action_type=OPEN_URL:参数数值为跳转URL

  • action_type=CALLING:参数数值为电话号码

  • action_type=OPEN_APP:参数数值为APP的跳转deeplink

  • action_type=OPEN_QUICK:参数数值为快应用跳转的deeplink

最小长度:0

最大长度:1000

ext_msg

ExtMsg object

额外需要携带的信息。

  • action_type=OPEN_SUBMENU时,不填

  • action_type=CALLING时,不填

  • action_type=OPEN_URL时,必填

  • action_type=OPEN_APP时,必填

  • action_type=OPEN_QUICK时,必填

sub_menu_items

Array of MenuItem objects

子菜单配置项。

说明:

仅当action_type=OPEN_SUBMENU时生效,且该项内不允许再配置子菜单。

数组长度:0 - 5

表6 ExtMsg

参数

是否必选

参数类型

描述

open_in_browser

String

打开方式。

  • 0:webView打开

  • 1:浏览器打开

说明:

action_type=OPEN_URL必填,其他不填。

web_title

String

标题,必填,长度范围为1-20个字符。

说明:

action_type=OPEN_URL必填,其他不填。

package_name

String

app包名,长度范围为1-50个字符。

说明:

action_type=OPEN_APP必填,其他不填。

app_id

String

商家应用的appid,长度范围为0-60个字符。

说明:

action_type=OPEN_APP必填,其他不填。

browser_floor_url

String

兜底url,长度范围为0-1000个字符,支持http/https。

说明:

action_type=OPEN_APP选填,其他不填。

depend_engine_ver

String

依赖的快应用引擎版本号,长度范围为1-50个字符。

说明:

action_type=OPEN_QUICK必填,其他不填。

third_service_name

String

第三方服务名,长度范围为1-50个字符。

说明:

action_type=OPEN_QUICK或OPEN_APP必填,其他不填。

响应参数

状态码: 200

表7 响应Body参数

参数

参数类型

描述

data

UpdateMenuRsp object

修改智能信息服务号菜单响应体。

表8 UpdateMenuRsp

参数

参数类型

描述

menu_id

String

菜单ID。

log_id

String

操作记录ID。

状态码: 400

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

结果详情。

状态码: 500

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

结果详情。

请求示例

根据菜单ID修改智能信息服务号菜单。设置修改原因为"业务调整",修改或添加菜单。

https://koomessage.myhuaweicloud.cn/v1/aim-sa/menus/34cffce987e64757bb9b711895714692

{
  "change_reason" : "业务调整",
  "menu" : {
    "menu_items" : [ {
      "action_type" : "OPEN_APP",
      "name" : "通过申请",
      "content" : "hap://app/xxxx.deeplink.xxxxx",
      "ext_msg" : {
        "package_name" : "baoming",
        "app_id" : "",
        "browser_floor_url" : "https://www.example.com/"
      }
    }, {
      "action_type" : "OPEN_URL",
      "name" : "打开链接",
      "content" : "https://www.example.com/",
      "ext_msg" : {
        "web_title" : "搜索",
        "open_in_browser" : "1"
      }
    }, {
      "action_type" : "OPEN_SUBMENU",
      "name" : "通过菜单",
      "ext_msg" : { },
      "sub_menu_items" : [ {
        "action_type" : "OPEN_URL",
        "name" : "搜索一下",
        "sub_menu_items" : [ ],
        "content" : "https://www.example.com/",
        "ext_msg" : {
          "web_title" : "url标题",
          "open_in_browser" : "1"
        }
      }, {
        "action_type" : "CALLING",
        "name" : "电一下",
        "sub_menu_items" : [ ],
        "content" : "131****0000"
      }, {
        "action_type" : "OPEN_APP",
        "name" : "手机软件",
        "sub_menu_items" : [ ],
        "content" : "hap://app/xxxx.deeplink.xxxxx",
        "ext_msg" : {
          "package_name" : "开心消消乐",
          "app_id" : "appid",
          "browser_floor_url" : "https://www.example.com/"
        }
      }, {
        "action_type" : "OPEN_QUICK",
        "name" : "快应用",
        "sub_menu_items" : [ ],
        "content" : "hap://app/11111111111",
        "ext_msg" : {
          "depend_engine_ver" : "快应用引擎",
          "third_service_name" : "服务名"
        }
      }, {
        "action_type" : "OPEN_QUICK",
        "name" : "快应用",
        "sub_menu_items" : [ ],
        "content" : "hap://app/dfs/dfdf",
        "ext_msg" : {
          "depend_engine_ver" : "v1.1.0",
          "third_service_name" : "测试"
        }
      } ]
    } ]
  }
}

响应示例

状态码: 200

返回信息。

{
  "data" : {
    "menu_id" : "34cffce987e64757bb9b711895714692",
    "log_id" : "6766"
  }
}

状态码

状态码

描述

200

返回信息。

400

非法参数。

500

内部错误。

错误码

请参见错误码

分享:

    相关文档

    相关产品