检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
状态码 HTTP响应状态码如表1所示。 表1 HTTP响应状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。
更新实例 接口说明 按周期售卖的商品,用户试用转正、续费、退续费后,云商店调用该接口,更新实例的到期日期。 客户商品转正、续费下单或退订续费周期后,云商店将调用该接口请求商家执行业务变更,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障更新实例接口通畅,如调用失败,将可能导致用户的业务被释放的风险。
HTTP Body签名 定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature,并且将signature通过URL PARAMS的方式添加到URL上,商家在接收到请求后需要同样的规则对请求体进行重新计算signature,并且与云商店传递的signature相比较,完全相同即为校验通过,通过URL
创建实例 接口说明 客户购买商品并付款成功,云商店将调用本接口通知商家创建实例。 商家需要返回此订单的唯一ID(instanceId)。建议此ID直接使用该订单首次请求时云商店传入的businessId,以确保instanceId的唯一性。 在正常购买场景中,请不要阻塞此接口,如
更新实例状态 接口说明 用户购买按周期计费商品后,对应的资源实例到期、违规等场景,云商店调用该接口,商家将指定的实例冻结。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如SaaS商品频繁出现因
authToken取值说明 接口整体要求: 仅支持HTTPS传输协议,协议版本不低于1.2,必须由信任机构颁发的证书。 仅支持域名地址。 使用POST方式提交请求。 接口的请求和详细均使用JSON格式。 统一使用UTF-8字符编码。 签名算法:HmacSHA256。 云商店的请求
异步申请License 接口说明 用户通过云商店向商家申请License。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如商品频繁出现因接口异常的情况,云商店将对该商品做下架处理。 云商店服务
在线开通License接口示例代码 基于spring boot构建的web工程,包含商家在云商店发布工业软件云联营License类商品时需要对接的生产接口示例代码。 具体操作请参考《在线开通License商品接入示例工程》。 父主题: 在线开通License接入指南
接口调用流程 接口调用的流程为: 获取AK/SK认证 调用接口前,请获取请求认证,并将认证字段填充至下一步中的方法中,进行请示构建,实现请求的认证。 调用接口采用AK/SK认证方式。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。
签名示例工程代码 签名示例工程代码请参考《AK/SK认证》。 父主题: 接口使用方法
Sdk::Init 场景描述 初始化函数,由工业软件调用,且必须首先调用。此函数可与ISCDesk建立连接,并执行相关初始化处理。 涉及接口 Sdk::Init 调用示例 invoker.IscdeskFactory()->Init(); 父主题: 基础功能
Sdk::ShutOut 场景描述 退出函数,由工业软件调用。工业软件关闭之前可主动调用此函数,断开与ISCDesk的连接,并释放资源。 涉及接口 Sdk::ShutOut 调用示例 invoker->ShutOut() 父主题: 基础功能
客户端工业软件改造流程 ISV对客户端工业软件进行改造时,需要根据改造功能模块说明将工业软件接入ISCDesk,并完成应用程序改造。工业软件改造之后,可实现在ISCDesk客户端的静默安装和卸载,以及管理在云、数据在云和计算在云功能。 图1 客户端工业软件改造流程 父主题: 客户端工业软件改造指南
Sdk::Save 场景描述 保存文件至云端函数,由工业软件调用。工业软件调用此函数可将单文件或装配体保存至云端,并触发“EVENT_SAVE_RESULT”保存结果回复事件,将保存文件结果连同事件一起告知工业软件。 保存单文件时,工业软件将需要保存的单文件路径传送至ISCDes
获取访问密钥ID 进入卖家中心页面。 单击左侧导航的“应用工具 > 密钥管理”,在“密钥管理”页面单击新增密钥ID后,获取访问密钥。 访问密钥用户接口请求的签名验证使用,请妥善保存,谨慎删除。 父主题: 接入准备工作
Sdk::SelectSaveAsPath 场景描述 另存文件至云端函数,由工业软件调用。工业软件调用此函数可将单文件或装配体另存为云端,并触发“EVENT_SAVE_RESULT”保存结果回复事件,将保存文件结果连同事件一起告知工业软件。 另存单文件时,工业软件将需要保存的单文
Sdk::RegisterEventRecall 场景描述 注册事件接收函数。此函数由工业软件调用,使用此函数可注册工业软件接收事件的回调函数。当前SDK会产生心跳回复事件、打开云端文件事件、保存结果回复事件、升级事件、ISCDesk客户端关闭事件、License验证事件,当SD
Sdk::GetLicenseFileRequest 场景描述 获取License文件请求函数,由工业软件调用。工业软件可根据需要(一般在工业软件启动时)调用此函数,向ISCDesk请求License文件。 调用此函数时,工业软件需要将License文件名通过“fileName”
Sdk::CheckNewVersions 场景描述 升级信息查询函数,由工业软件调用。工业软件查询升级信息时,调用此函数,向ISCDesk查询是否存在升级版本。查询成功后会触发“EVENT_UPGRADENOTICE”事件,将升级信息告知工业软件。 升级信息样例如下: {"op
Sdk::LicenseVerifyNotify 场景描述 License验证结果通知函数,由工业软件调用。工业软件对License进行验证后,调用此函数,将License验证结果(成功或失败)通知ISCDesk。如果License验证失败,则需要将错误信息一同通知ISCDesk。