文档首页 > > 用户指南> 服务商> 商品接入> SaaS商品应用接入调试

SaaS商品应用接入调试

分享
更新时间: 2020/03/25 GMT+08:00

针对SaaS类商品:

  • 为了保证使用SaaS接入方式的正确性,华为云云市场为服务商在卖家中心搭建了应用接入调试界面。服务商可以在此页面调试接口的正确性。
  • 提供生产接口消息提示功能,记录华为云云市场调用接口成功和失败情况。

应用接入调试

以“新购商品”接口为例进行说明。

  1. 请参照请求消息中的参数说明在ISV Server中预置参数值。
  2. 进入卖家中心页面。
  3. 单击左侧导航的“应用接入 > 应用接入调试”。
  4. 在右侧页面的“新购商品”页签,填写1中预置的各个参数值,单击“生成链接地址”生成请求消息示例。

    (可选)如需发布支持多SKU定价的商品规格,且定价属性中包含数量类型的属性(数量、带宽、硬盘大小等),请先在商品属性管理页面新建数量类型属性,然后回到调试页面选择要进行调试的数量类型属性,填写参数值。接口调试通过后,即可发布包含数量类型定价属性的SKU定价的商品。

    (可选)“扩展参数”:如需用户订购时填写额外参数信息,需点击“添加扩展参数”选择参数类型,最多支持添加3条。如需添加默认值之外的参数类型,请先通过云市场邮箱联系运营经理申请配置所需的参数类型,具体申请结果以云市场反馈为准。

    参数说明

    参数名称

    解释

    生产地址

    URL

    服务商接受云市场请求的服务地址

    客户ID

    customerId

    客户在华为云注册的唯一标识

    客户名称

    customerName

    客户在华为云的注册名称

    用户ID

    userId

    客户在华为云创建用户时系统自动生成的唯一标识

    用户名

    userName

    客户在华为云创建用户时设置的用户名称

    手机号

    mobilePhone

    客户注册华为云时绑定的手机号

    说明:

    手机号不包含国家码。

    邮箱

    email

    客户注册华为云时绑定的邮箱

    云市场业务ID

    businessId

    UUID

    云市场订单ID

    orderId

    客户购买商品时生成的订单唯一标识

    产品规格标识

    skuCode

    客户购买产品规格的唯一标识

    说明:

    该参数可在商品审核上架后,进入“卖家中心 > 商品管理 > 我的商品 ”页面,单击该商品操作列的“详情”进入商品详情页面获取。

    产品的ID

    productId

    发布产品时生成的产品标识

    说明:

    该参数可在商品审核上架后,进入“卖家中心 > 商品管理 > 我的商品 ”页面,单击该商品操作列的“详情”进入商品详情页面获取。

    过期时间

    expireTime

    客户购买SaaS产品生成订单的到期时间

    计费模式

    chargingMode

    发布产品时选择的计费模式:

    • 包周期(默认值)
    • 按次

    敏感信息加密算法

    encryptType

    加密手机号和邮箱所用的加密算法:

    • AES256_CBC_PKCS5Padding(默认值)
    • AES128_CBC_PKCS5Padding
    说明:

    敏感信息加密算法是服务商在发布产品时所选择的加密算法,不能随意填写,否则会导致用户名、密码解密失败。

    是否是开通试用实例

    trialFlag

    是否是开通试用实例

    1:试用实例

    0:非试用实例

    不传试用参数:2018年5月12日之前已发布成功的产品实例

    数量

    amount

    数量类型的商品定价属性。非必填。

    属性名称:数量(支持服务商自定义名称)

    单位:个(次)

    说明:

    对于包周期或一次性计费的SaaS商品,租户下单购买包含“数量”线性属性的规格时,会填写及调整购买的个数或次数。

    例如:30个用户

    硬盘大小

    bandWidthdiskSize

    数量类型的商品定价属性。非必填。

    属性名称:硬盘大小(支持服务商自定义名称)

    单位:GB

    说明:

    对于包周期或一次性计费的SaaS商品,租户下单购买包含“硬盘大小”线性属性的规格时,会填写及调整购买多少GB。

    例如:100GB

    带宽

    bandWidth

    数量类型的商品定价属性。非必填。

    属性名称:带宽(支持服务商自定义名称)

    单位:Mbps

    说明:

    对于包周期或一次性计费的SaaS商品,租户下单购买包含“带宽”线性属性的规格时,会填写及调整购买多少Mbps。

    例如:20Mbps

    • 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为发布商品时填写值。

  5. 单击“调测并保存用例”。

    系统会调用生产链接进行接口测试,如测试成功则会保存对应用例,继续执行6;如测试失败,则会在页面下方展示对应错误信息,可根据对应信息进行接口修改。

    • 如果发布包周期商品,需要调测和保存“新购商品”、“续费”、“过期”、“释放”四种场景的测试用例,且“新购商品”场景的计费模式需要选择包周期。
    • 如果发布按次商品,需要调测和保存“新购商品”和“释放”场景的测试用例,其中“新购商品”场景的计费模式需要选择按次;包周期和按次同时发布时,只需要一个释放接口用例。
    • 如果同时发布包周期和按次商品,则需要调测和保存“新购商品”、“续费”、“过期”、“释放”四种场景的测试用例,且“新购商品”场景需保存两条测试用例计费模式分别选择包周期和按次。

  6. 系统提示“调测用例成功!”,单击“保存用例”。

    调测成功的用例可以在“应用接入 > 调测用例管理”页面进行查询。

生产接口消息

当接口调用失败时,生产接口消息中可查询接口“异常信息”,服务商需根据提示尽快处理接口异常。

针对新购场景接口调用失败的情况,云市场会持续调用到60次(每3分钟1次)后停止调用。若服务商接口问题在60次调用时间内解决,则在下一次调用时调用成功;若服务商接口问题在60次调用后仍无解决,系统则判断订单为失败,并自动进行订单退订。

  1. 进入卖家中心页面。
  2. 单击左侧导航的“交易管理 > 生产接口消息”。
  3. 查询接口调用记录。

调测用例管理

为方便服务商在进行SaaS商品接入时,进行生产接口的调测并确保用例调测通过,服务商在“应用接入调试”页面对调测通过的用例进行保存添加后,可以在此页面进行用例的管理。

  1. 进入卖家中心页面。
  2. 单击左侧导航的“应用接入 > 调测用例管理”。
  3. 管理调测用例。

    • 单击操作列的“调测”,跳转到“应用接入调试”页面,并自动加载用例信息。
    • 单击操作列的“删除”,可删除相应用例。

    已发布成功的商品的用例,不允许执行“删除”操作。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区