云服务器内容精选

  • 请求示例 根据菜单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 表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 结果详情。
  • 请求参数 表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-24个字符。 当菜单数量为2个时,菜单名长度范围在1-12个字符。 当菜单数量为3个时,菜单名长度范围在1-8个字符。 二级菜单名长度范围恒为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必填,其他不填。
  • 相关操作 添加自定义配置:填写配置名然后选择自定义时间后,参考表1填写相关参数。 添加自定义配置前,需要先填写默认配置。 最多只可添加5个自定义配置。 预览快捷键:单击对应“操作”列下的“预览”按钮,弹出“预览”对话框,可进行左右横滑,查看默认配置和自定义配置。 修改快捷键:单击对应“操作”列下的“修改”按钮,进入到“修改快捷键名称”页面,修改完成后单击“申请”,弹出“预览”框,确认内容无误后,单击“确认”。 冻结快捷键:单击对应“操作”列下的“冻结”按钮,弹出“冻结”对话框,输入冻结原因,单击“确定”。 解冻快捷键:单击对应“操作”列下的“解冻”按钮,弹出“解冻”对话框,单击“确定”。
  • 请求示例 更新服务号信息 https://koomessage.myhuaweicloud.cn/v1/aim-sa/pubs/29333b06990f4a5ca3b13ffb0c67cccc{ "pub_name" : "尊享酷玩", "pub_remark" : "仅测试使用", "pub_abstract" : "尊享酷玩的摘要", "logo_img" : "6245269fa0214a81b55f12ec3c81cccc", "auto_get_port" : 1, "authorization_files" : [ "f3335e54b86145409cacfac4bf17cccc" ], "industry" : 2, "signs_for_auto_get_port" : [ "华为云KooMessage" ], "change_reason" : "修改名称"}
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 data UpdatePubResponse object 更新服务号信息响应体。 表5 UpdatePubResponse 参数 参数类型 描述 data data object 请求成功返回的数据,为JSON格式。 表6 data 参数 参数类型 描述 pub_update_log_id String 可使用该ID查询当前记录审核情况。 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 结果详情。 状态码: 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 结果详情。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Content-Type 是 String 请求体参数类型,该字段必须设置为:application/json。 表3 请求Body参数 参数 是否必选 参数类型 描述 change_reason 是 String 更新原因。 最小长度:1 最大长度:200 logo_img 否 String 服务号LOGO图片资源ID。 说明: 通过上传智能信息服务号图片资源接口上传LOGO图片后获得的图片resource_id。图片要求大于等于240*240且比例相同。 最小长度:32 最大长度:32 authorization_files 否 Array of strings 授权证明图片资源ID,最多支持6张。 pub_name 否 String 服务号名称。 最小长度:1 最大长度:15 pub_abstract 是 String 服务号简介。 最小长度:1 最大长度:75 pub_remark 否 String 服务号摘要。 最小长度:1 最大长度:15 auto_get_port 否 Integer 自动获取端口。 最小值:0 最大值:1 signs_for_auto_get_port 否 Array of strings 自动收集端口使用的签名列表。 说明: auto_get_port为1时,该字段为必填,每个签名长度须为2-18个字符,每个服务号签名不可以重复。 industry 否 Integer 从事行业,默认取服务号所属商家的行业分类。 1:金融理财 2:社交通讯 3:影音娱乐 4:旅游出行 5:购物 6:本地生活 7:运动健康 8:教育培训 9:新闻阅读 10:运营商 11:其他 最小值:1 最大值:11
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 change_reason 是 String 修改原因。 最小长度:5 最大长度:50 background_img 是 String 主页背景图片资源ID。 分辨率大于等于1440*810,支持jpg、jpeg、bmp、png。参数值为上传智能信息服务号图片资源API返回的resource_id。 最小长度:32 最大长度:32 summary 是 String 简介。 最小长度:1 最大长度:75 tels 否 Array of TelModel objects 热线号列表。 fastapps 否 Array of UpdatePortalFastappModel objects 快应用列表。 hw_pubs 否 Array of strings 华为服务号列表。 说明: 预留,暂未使用。 表4 TelModel 参数 是否必选 参数类型 描述 tel 是 String 电话号码(只能包含数字和“-”,且开头和结尾必须为数字)。 最小长度:1 最大长度:20 usage 是 String 号码用途。 说明: 号码用途长度范围为1-30个字符,中文占2个字符,英文占1个字符。 表5 UpdatePortalFastappModel 参数 是否必选 参数类型 描述 name 否 String 快应用名。 说明: 长度范围为1-30个字符,中文占2个字符,英文占1个字符。 logo_img 否 String 快应用LOGO图片资源ID。 说明: 图片格式为jpg、bmp、jpeg,分辨率大于等于192*192,比例+-0.15,大小不超过5M。参数值为上传智能信息服务号图片资源API返回的resource_id。 最小长度:32 最大长度:32 description 否 String 快应用描述。 说明: 长度范围为1-38个字符,中文占2个字符,英文占1个字符。 deeplink 否 String 快应用跳转链接。 最小长度:1 最大长度:1000 depend_engine_version 否 String 快应用依赖引擎版本。 说明: 长度范围为1-50个字符,中文占2个字符,英文占1个字符。
  • 响应参数 状态码: 200 表6 响应Body参数 参数 参数类型 描述 data UpdatePortalRsp object 修改主页信息响应体。 表7 UpdatePortalRsp 参数 参数类型 描述 portal PortalModel object 主页信息。 表8 PortalModel 参数 参数类型 描述 portal_id String 主页ID。 company_id String 企业ID。 company_name String 企业名称。 pub_id String 服务号ID。 pub_name String 服务号名称。 background_img String 主页背景图片资源ID。 background_img_url String 背景图片URL。 summary String 简介。 tels String 热线号列表。 说明: 以JSON列表返回,格式: {"tel": "400-800-8800", "usage": "官方服务电话"}。 fastapps String 快应用列表。 说明: 以JSON列表返回,格式: {"name": "快应用名称","logo_img": "快应用LOGO图片资源ID", "logo_img_url": "快应用LOGO图片资源URL", "description": "快应用描述","deeplink": "hap://app/fastapp","depend_engine_version": "1040"}。 state Integer 主页状态。 1:未生效 2:已生效 3:已失效 4:服务号已冻结 approve_state Integer 审核状态。 1:待审核 2:通过 3:驳回 online_time String 上线时间。 creator String 创建人。 create_time String 创建时间。 change_reason String 修改原因。 状态码: 400 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 结果详情。 状态码: 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 结果详情。
  • 响应示例 状态码: 200 返回信息。 { "data" : { "portal" : { "portal_id" : "bcce7e60df6445a592c09ca95dfdcccc", "state" : 1, "approve_state" : 1, "company_id" : "cf2d298c555e44bf9fafdf5ada0ccccc", "company_name" : "南派餐饮", "creator" : "7139bc07d53240dca88722930485cccc", "create_time" : "2022-08-08T01:49:29Z", "change_reason" : "我想修改主页", "pub_id" : "961b0f7d32314b5cb287fc06fe09cccc", "pub_name" : "服务号名称", "background_img" : "1d191b06da9a485895e10e48cbc5cccc", "background_img_url" : "AimSauploadService/ad63cdaa3a044a589bbde7f6a4551111.png", "summary" : "测试-欢迎来到酷玩影视", "tels" : "[{\"usage\":\"加入我们\",\"tel\":\"131****0000\"},{\"usage\":\"联系我们\",\"tel\":\"131****0001\"}]", "fastapps" : "[{\"name\":\"酷玩\",\"logo_img\":\"d2fe995119584f88be9e9ef53d2ccccc\",\"logo_img_url\":\"AimSauploadService/ccccd328eba84b27ab215122aada398ftest22_192x192 (1).jpg\",\"description\":\"这是一个快应用的描述\",\"deeplink\":\"hap://app/122\",\"depend_engine_version\":\"1\"}]", "approve_time" : null, "online_time" : null } }}
  • 请求示例 修改主页 https://koomessage.myhuaweicloud.com/v1/aim-sa/portals/bcce7e60df6445a592c09ca95dfdcccc{ "change_reason" : "我想修改主页", "background_img" : "1d191b06da9a485895e10e48cbc5cccc", "summary" : "测试-欢迎来到酷玩影视", "tels" : [ { "tel" : "131****0000", "usage" : "加入我们" }, { "tel" : "131****0001", "usage" : "联系我们" } ], "fastapps" : [ { "name" : "酷玩", "description" : "这是一个快应用的描述", "deeplink" : "hap://app/122", "depend_engine_version" : "1", "logo_img" : "d2fe995119584f88be9e9ef53d2ccccc" } ]}
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 data DeletePortResponseBody object 通道号删除返回体。 表4 DeletePortResponseBody 参数 参数类型 描述 data data object 消息体。 表5 data 参数 参数类型 描述 port String 通道号。 port_type Integer 通道号类型。 1:普通 3:前缀号段 5:后缀号段 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 结果详情。 状态码: 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 结果详情。