检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
订单通知接口描述 客户购买商品并付款成功后,云商店将调用本接口通知商家。 云商店将调用订单通知接口,将订单号同步至商家生产系统中。 商家系统收到该请求信息,需调用云商店查询订单接口,获取本次订购的相关信息。 订单通知接口调用流程如下图所示: 请求参数说明请参见下表。云商店会结合商家创建上架的商品售卖模式来对应请求
状态码 HTTP响应状态码如下表所示。 表1 HTTP响应状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议
状态码 HTTP响应状态码如下表所示。 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTP
调用结果码说明 模块 结果码 结果码说明 公共 000000 成功 000001 鉴权失败 000002 请求参数不合法 000003 实例ID不存在(商品续费、过期、资源释放接口可能返回) 000004 请求处理中 000005 其它服务内部错误 新购商品 000100 无可用实例资源分配
调用结果码说明 模块 结果码 结果码说明 公共 000000 成功 000001 鉴权失败 000002 请求参数不合法 000003 实例ID不存在 000004 请求处理中 000005 其他服务内部错误 新购商品 000100 无可用实例资源分配 000101 Mobile
License类商品服务监管 当License类商品成功售出后,服务商在卖家中心“交易管理>服务监管”查看订单信息,向用户线下交付License,并在卖家中心页面确认服务已完成。 注意事项 服务监管流程未完成的订单,订单状态为“处理中”,待用户确认验收后3个小时内,订单状态会同步为
更新授权码有效期 接口说明 包周期License商品实现续费、退续费场景下,商家通过该接口更新对应授权码有效期。 用户续费下单,云商店将调用该接口请求商家执行业务延期,商家接口需要更新到期日,并返回通知云商店。 商家需要保障接口通畅,执行业务延期,如续费失败,可能导致该授权码对应的资源被释放
商品续费 接口说明 按周期售卖的商品,商家必须实现续费接口生产开发。 客户续费下单或试用商品转正后,云商店将调用该接口请求商家执行业务延期,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障续费接口通畅,将业务进行延期,如续费失败,将可能导致用户的业务被释放的风险。
Sdk::GetLicenseStringRequest 场景描述 获取License字符串请求函数,由工业软件调用。工业软件可根据需要(一般在工业软件启动时)调用此函数,向ISCDesk请求License字符串。 调用此函数时,工业软件需要将申请License时所需的设备信息通过
Sdk::Save 场景描述 保存文件至云端函数,由工业软件调用。工业软件调用此函数可将单文件或装配体保存至云端,并触发“EVENT_SAVE_RESULT”保存结果回复事件,将保存文件结果连同事件一起告知工业软件。 保存单文件时,工业软件将需要保存的单文件路径传送至ISCDesk
授权码心跳检测 功能介绍 商家进行授权码的激活后,用户每日首次使用License软件时,商家需要调用该接口,若不使用则无需调用。 URI POST https://mkt.myhuaweicloud.com/api/mkp-openapi-public/global/v1/license
License相关 在进行License验证时,需要收集用户设备指纹信息,包括MAC地址、硬盘序列号、主板序列号和CPU序列号。设备指纹最大长度限制为5K字节。 设备指纹字符串拼接时,各参数之间以“|”号分割,获取不到时就为空。获取到的MAC地址和硬盘序列号有多个时,以英文“,”号分隔
释放授权码 接口说明 用户购买的商品过期并超过保留期后,云商店调用该接口,商家接到该通知以后应该将授权码对应的资源释放。 云商店调用该接口时,商家需要保障接口通畅,对该授权码对应的资源进行释放,如释放失败,可能导致用户仍可使用该资源。 针对商品过期且未续费的场景下,接口调用失败的情况
创建实例 接口说明 客户购买商品并付款成功,云商店将调用本接口通知商家创建实例。 商家需要返回此订单的唯一ID(instanceId)。建议此ID直接使用该订单首次请求时云商店传入的businessId,以确保instanceId的唯一性。 在正常购买场景中,请不要阻塞此接口,如果耗时较长
租户信息同步接口 接口说明 买家购买联营SaaS商品后,在买家中心登录,将应用与企业绑定时,云商店调用该接口请求商家同步该企业的租户信息,商家接口需要执行租户同步,保存租户信息,并返回通知云商店。 针对租户同步场景接口调用失败的情况,由买家选择是否重试,并用短信或邮件的形式通知商家接口调用失败
商品升级 接口说明 用户对已购买的商品进行升级,升级订单付款成功后,云商店调用该接口请求商家升级用户购买的商品,商家接口需要执行商品升级,并返回通知云商店。 针对升级场景接口调用失败的情况,云商店会持续调用3小时后停止调用,期间商家可在“卖家中心>生产接口消息”页面单击对应订单右侧操作栏的
请求认证说明 定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature,并且将signature通过URL PARAMS的方式添加到URL上,商家在接收到请求后需要同样的规则对请求体进行重新计算signature,并且与云商店传递的signature相比较,完全相同即为校验通过
实例升级 接口说明 用户对已购买的资源进行升级,升级订单付款成功后,云商店调用该接口请求商家升级用户购买的资源,商家接口需要执行资源升级,并记录用户升级后的产品数据。 商品升级流程如下图所示: 请求消息 请求参数说明请参见下表: 请求方法:POST 参数 是否必选 类型 取值范围
更新实例 接口说明 按周期售卖的商品,用户试用转正、续费、退续费后,云商店调用该接口,更新实例的到期日期。 用户进行商品转正、续费下单或退订续费周期后,云商店将调用该接口请求商家执行业务变更,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障更新实例接口通畅,如调用失败
释放实例 接口说明 用户释放购买产品的实例时(到期不续费、退订等场景),云商店调用该接口,商家将对应的实例进行删除。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如商品频繁出现因接口异常的情况,