SaaS商品应用接入调试及调试用例管理
针对SaaS类商品:
- 为了保证使用SaaS接入方式的正确性,华为云云商店为商家在卖家中心搭建了应用接入调试界面。商家可以在此页面调试接口的正确性。
- 提供生产接口消息提示功能,记录华为云云商店调用接口成功和失败情况。
应用接入调试
以“新购商品”接口为例进行说明。
- 请参照请求消息中的参数说明在ISV Server中预置参数值。
- 进入卖家中心页面。
- 单击左侧导航的“应用接入 > 应用接入调试”。
- 在右侧页面的“新购商品”页签,填写1中预置的各个参数值,单击“生成链接地址”生成请求消息示例,各参数说明参考接口描述。
(可选)如需发布支持多SKU定价的商品规格,且定价属性中包含数量类型的属性(数量、带宽、硬盘大小等),请先在商品属性管理页面新建数量类型属性,然后回到调试页面选择要进行调试的数量类型属性,填写参数值。接口调试通过后,即可发布包含数量类型定价属性的SKU定价的商品。
(可选)“扩展参数”:如需用户订购时填写额外参数信息,需点击“添加扩展参数”选择参数类型,最多支持添加3条,且选择的扩展参数,需在接口调试中已调试通过。如需添加默认值之外的参数类型,请先通过云商店邮箱partner@huaweicloud.com联系运营经理申请配置所需的参数类型,具体申请结果以云商店反馈为准。
- 如发布的SaaS商品不涉及服务监管,“商品实例开通方式”请选择“用户购买后同步开通”;如发布的SaaS商品涉及服务监管,“商品实例开通方式”请选择“用户确认验收后开通”。
- 2018年5月12日新增接口参数:trialFlag和skuCode。
- 2018年5月12日之后发布产品或已发布成功的产品新增规格时,请填写此新参数并通过接口调试(trialFlag的三种值都要调试通过)。
- 2018年5月12日之前已发布成功的产品如果不涉及免费试用变更,不要求做接口调试。
- 2018年8月9日新增SaaS计费模式“按次”发布接口,如需选择“按次”发布,遵循SaaS类商品接入指南调试通过后才可选择该计费模式“按次”发布商品。
- 接入调试时使用的各参数值,除生产地址外,其他参数皆使用虚拟参数即可,如:“123456789”等。
- 系统会保存调测通过的测试用例,商品发布、修改及审核上架时会调用保存的用例对接口进行校验,同时云商店会定期调用保存的用例进行统一调测。
- 扩展参数。非必填。
扩展参数格式为json数组字符串通过urlEncode(base64(saasExtendParams))携带到url参数中。在得到saasExtendParams参数的值后,需要通过base64Decode(urlDecode(saasExtendParams))获取扩展参数json数组。
例如:[{"name":"emailDomainName","value":"test.xxxx.com"},{"name":"extendParamName","value":"extendParamValue"}]
其中emailDomainName和extendParamName为发布商品时填写值。
发布WeLink开放平台开发的商品时,请先在应用接入调试页面调测“WeLink商品接口调测必选参数”,测试请参照如下截图:
tenantName: isv测试企业
tenantId: 4CA08CF8F3E34566A07584D4C74D41ED
userId: admin@isvtest
- 单击“调测并保存用例”。
系统会调用生产链接进行接口测试,如测试成功则会保存对应用例,继续执行6;如测试失败,则会在页面下方展示对应错误信息,可根据对应信息进行接口修改。
- 如果发布包周期商品,需要调测和保存“新购商品”、“续费”、“过期”、“释放”四种场景的测试用例,且“新购商品”场景的计费模式需要选择包周期。
- 如果发布按次商品,需要调测和保存“新购商品”和“释放”场景的测试用例,其中“新购商品”场景的计费模式需要选择按次。
- 如果同时发布包周期和按次商品,则需要调测和保存“新购商品”、“续费”、“过期”、“释放”四种场景的测试用例,且“新购商品”场景需保存两条测试用例计费模式分别选择包周期和按次,“释放”场景为两种计费模式共用一个用例。
- “升级”场景,不做强制要求,如所发布的商品有升级场景,则进行调试;如无,则无需调试。
- 系统提示“调测用例成功!”,单击“保存用例”。
调测成功的用例可以在“应用工具 > 调测用例管理”页面进行查询。
生产接口消息
当接口响应失败时,系统会邮件通知到商家云商店账号绑定的邮箱,“卖家中心>生产接口消息”中可查询接口“异常信息”,商家收到通知后须尽快处理接口异常,避免订单失败退订。
- 针对新购场景接口调用失败的情况,云商店会持续调用3小时(每小时1次)后停止调用,期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试。若商家接口问题在3小时调用时间内解决,则在下一次调用接口响应成功,订单开通成功;若商家接口问题在3小时调用后仍未解决,系统则判断订单为失败,并自动进行订单退订。
- 针对续费场景接口调用失败的情况,云商店会调用1次,“卖家中心>生产接口消息”中可查询接口“异常信息”,请在修复接口异常后,通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”,单击右侧操作栏的“重新启动”进行手动重试。
- 针对过期(冻结、解冻、释放)场景接口调用失败的情况,云商店会调用1次,“卖家中心>生产接口消息”中可查询接口“异常信息”,请在修复接口异常后,通知云商店partner@huaweicloud.com对该失败调用进行重新调用或自行在“卖家中心>生产接口消息”页面中查询接口“异常信息”,单击右侧操作栏的“重新启动”进行手动重试。
- 针对升级场景接口调用失败的情况,云商店会持续调用3小时(每小时1次)后停止调用,期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试。若商家接口问题在3小时调用时间内解决,则在下一次调用接口响应成功,订单开通成功;若商家接口问题在3小时调用后仍未解决,系统则判断订单为失败,并自动进行订单退订。
- 进入卖家中心页面。
- 单击左侧导航的“交易管理 > 生产接口消息”。
- 查询接口调用记录。
调测用例管理
为方便商家在进行SaaS商品接入时,进行生产接口的调测并确保用例调测通过,商家在“应用接入调试”页面对调测通过的用例进行保存添加后,可以在此页面进行用例的管理。
调测成功并保存的用例,在发布商品上架后,云商店会定期对商品对应的调测用例进行自动调测,若调测时接口响应异常,将以邮件形式通知,请收到通知后2个工作日内定位接口异常原因并修复,逾期未修复的,商品将下架处理。
- 进入卖家中心页面。
- 单击左侧导航的“应用接入 > 调测用例管理”。
- 管理调测用例。
- 单击操作列的“调测”,跳转到“应用接入调试”页面,并自动加载用例信息。
- 单击操作列的“删除”,可删除相应用例。
已发布成功的商品的用例,不允许执行“删除”操作。