检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
云商店开放接口描述 云商店开放接口说明 接口使用方法 公共参数 接口兼容性说明 接口列表 测试授权码激活和心跳检测 错误码 父主题: 联营License类授权码商品接入指南(2.0版本)
接口安全令牌 在云商店发布License类授权码商品时,商家需要开发生产接口与云商店平台对接,根据接口规则实现相关的接口定义。用户在云商店对购买License商品续费、退订后,云商店会回调商家实现的生产接口来更新授权码状态,从而为用户使用的License商品统一进行生命周期管理。每一次接口调用都必须进行安全校验
请求认证说明 定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature,并且将signature通过URL PARAMS的方式添加到URL上,商家在接收到请求后需要同样的规则对请求体进行重新计算signature,并且与云商店传递的signature相比较,完全相同即为校验通过
商家接入接口说明 商家发布License授权码商品时,需在生产接口服务器开发一个生产接口。 同一个商品发布时,针对不同的调用场景(续费、过期、释放),只需要配置一个“生产系统接口地址”。 客户续费下单付款成功后,云商店将调用该接口(续费场景)请求商家执行业务延期,商家接口需要更新到期日
公共参数 公共请求消息头参数 公共响应消息头参数 父主题: 云商店开放接口指南
接口调试 为了保证使用在线开通License类商品接入方式的正确性,云商店为商家在卖家中心搭建了应用接入调试界面。商家可以在此页面调试接口,在5个调用场景(创建实例、更新实例、更新实例状态、释放实例和异步申请License)的正确性。下面以“创建实例”接口为例进行说明。 操作步骤
IAM账号权限 如果是IAM子用户的ak、sk,请先登录主账号添加“编程访问”权限 登录华为云主账号,访问“统一身份认证服务”。 选择需要访问的IAM子用户。 勾选“编程访问”后,点击确定即可。 请求签名流程 第三方应用对华为云API的访问需经过签名认证。
激活授权码 功能介绍 用户购买联营License商品后,订单进入服务监管流程,在此期间商家实施交付后,用户侧可以获取授权码。在用户确认商品验收通过后,通过线下或线上手段将授权码交给商家,商家通过软件集成该接口,对授权码进行激活处理,实现客户使用软件的统一生命周期管理。 URI POST
接口描述 创建实例 更新实例 更新实例状态 释放实例 异步申请License 父主题: 在线开通License接入指南
更新实例 接口说明 按周期售卖的商品,用户试用转正、续费、退续费后,云商店调用该接口,更新实例的到期日期。 客户商品转正、续费下单或退订续费周期后,云商店将调用该接口请求商家执行业务变更,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障更新实例接口通畅,如调用失败
接口列表 查询订单 字符串/文件流上传 父主题: 云商店开放接口指南
接入准备工作 获取访问密钥ID authToken取值说明 HTTP Body签名 父主题: 在线开通License接入指南
创建实例 接口说明 客户购买商品并付款成功,云商店将调用本接口通知商家创建实例。 商家需要返回此订单的唯一ID(instanceId)。建议此ID直接使用该订单首次请求时云商店传入的businessId,以确保instanceId的唯一性。 在正常购买场景中,请不要阻塞此接口,如果耗时较长
释放实例 接口说明 用户释放购买产品的实例时(到期不续费、退订等场景),云商店调用该接口,商家将对应的实例进行删除。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如商品频繁出现因接口异常的情况,
调用结果码说明 模块 结果码 结果码说明 公共 000000 成功 000001 鉴权失败 000002 请求参数不合法 000003 实例ID不存在(更新实例、更新实例状态、释放实例接口可能返回) 000004 请求处理中 000005 其它服务内部错误 创建实例 000100
接口使用方法 使用方法 接口调用流程 获取AK/SK认证 构造请求方法 发起请求 解析消息响应 状态码 签名示例工程代码 父主题: 云商店开放接口指南
公共错误码 表1 错误码 http状态码 error_code error_msg 描述 200 CBC.0000 Success 成功 403 CBC.0150 Illegal operation 鉴权失败 400 CBC.0101 Invalid parameter 请求参数不合法
获取Key值(访问密钥) 进入卖家中心页面。 单击左侧导航的“应用工具 > 密钥管理”,在“密钥管理”页面单击新增密钥ID后,获取访问密钥。 访问密钥用户接口请求的签名验证使用,请妥善保存,谨慎删除。 父主题: 接口安全令牌
开放接口示例代码 具体操作请参考《云商店开放接口示例工程》,路径如下: 父主题: 云商店开放接口指南
更新实例状态 接口说明 用户购买按周期计费商品后,对应的资源实例到期、违规等场景,云商店调用该接口,商家将指定的实例冻结。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如SaaS商品频繁出现因接口异常的情况