检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口使用方法 使用方法 接口调用流程 获取AK/SK认证 构造请求方法 发起请求 解析消息响应 状态码 签名示例工程代码 父主题: 云商店开放接口描述
公共错误码 表1 错误码 http状态码 error_code error_msg 描述 200 92020000 Success 成功 200 92020001 internal error 其它服务内部错误 200 92020002 invalid param 请求参数不合法
HTTP-Version Status-Code Reason-Phrase CRLF HTTP-Version:表示服务器HTTP协议的版本号。 Status-Code:表示服务器发回的响应状态代码。 状态代码有三位数字组成,第一个数字定义了响应的类别,且有五种可能取值: 1x
心跳检测信息 heartbeatInfo为Json格式,支持扩充,云商店会校验关键key必输,对于已经对接过该接口的商家,云商店会保持对以往版本的兼容。 表2 HeartbeatInfo 参数 是否必选 参数类型 最大字符长度 描述 thirdParty Account M String
针对续费场景接口调用失败的情况,云商店会持续调用60次(每2分钟1次)后停止调用,重试频率为2分钟一次,“卖家中心>生产接口消息”中可查询接口“异常信息”。商家修复接口异常后,在云商店对该失败调用进行重新调用。 请注意查看商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件后及时处理接口异常。 云商
发起请求 共有二种方式可以基于已构建好的请求消息发起请求,分别为: cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。关于cURL详细信息请参见https://curl
请求认证说明 定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature,并且将signature通过URL PARAMS的方式添加到URL上,商家在接收到请求后需要同样的规则对请求体进行重新计算signature,并且与云商店传递的signature相比较,完全相同即为校验通过,通过URL
接口调用流程 接口调用的流程为: 获取AK/SK认证 调用接口前,请获取请求认证,并将认证字段填充至下一步中的方法中,进行请示构建,实现请求的认证。 调用接口采用AK/SK认证方式。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。
APIGW网关错误码 APIGW网关错误码请参考《错误码》。 父主题: 云商店开放接口描述
使用方法 华为云API符合RESTful API设计理论。 REST从资源的角度观察整个网络,分布在各处的资源由URI(Uniform Resource Identifier)确定,客户端的应用通过URL(Unified Resource Locator)获取资源。 URL的一般
测试授权码激活和心跳检测 为了保证License授权码接入方式的正确性,云商店为商家在卖家中心搭建了申请测试授权码的界面。商家可以在此页面申请一个或者多个测试授权码来调试License软件集成验证,通过授权码管理License软件的统一生命周期和心跳检测的正确性。 操作步骤 在“卖家中心
获取AK/SK认证 生成AK、SK 注册并登录云商店,点击云商店首页右上角的“卖家中心”,进入卖家中心后台。 点击卖家中心左上角的“控制台”,进入管理控制台。 单击页面右上角的用户名,在下拉列表中单击“我的凭证”,进入“我的凭证”页面。 单击页面左侧导航中的“管理访问密钥”,进入“访问密钥”页面。
签名示例工程代码 签名示例工程代码请参考《AK/SK认证》。 父主题: 接口使用方法
激活授权码 功能介绍 用户购买联营License商品后,订单进入服务监管流程,在此期间商家实施交付后,用户侧可以获取授权码。在用户确认商品验收通过后,通过线下或线上手段将授权码交给商家,商家通过软件集成该接口,对授权码进行激活处理,实现客户使用软件的统一生命周期管理。 URI POST
商家接入接口说明 商家发布License授权码商品时,需在生产接口服务器开发一个生产接口。 同一个商品发布时,针对不同的调用场景(续费、过期、释放),只需要配置一个“生产系统接口地址”。 客户续费下单付款成功后,云商店将调用该接口(续费场景)请求商家执行业务延期,商家接口需要更新到期日,并将执行结果返回给云商店。
获取Key值(访问密钥) 进入卖家中心页面。 单击左侧导航的“应用工具 > 密钥管理”,在“密钥管理”页面单击新增密钥ID后,获取访问密钥。 访问密钥用户接口请求的签名验证使用,请妥善保存,谨慎删除。 父主题: 接入准备工作
Sdk::CheckNewVersions 场景描述 升级信息查询函数,由工业软件调用。工业软件查询升级信息时,调用此函数,向ISCDesk查询是否存在升级版本。查询成功后会触发“EVENT_UPGRADENOTICE”事件,将升级信息告知工业软件。 升级信息样例如下: {"op
公共响应消息头参数 表1 公共响应消息头 名称 描述 示例 Date HTTP协议标准报头。表示消息发送的时间,时间的描述格式由rfc822定义。 Mon, 12 Nov 2007 15:55:01 GMT Server HTTP协议标准报头。包含了服务器用来处理请求的软件信息。
公共请求消息头参数 表1 公共请求消息头 名称 描述 是否必选 示例 x-sdk-date 请求的发生时间,格式为:yyyyMMdd'T'HHmmss'Z'。 取值为当前系统的GMT时间。 否 使用AK/SK认证时必选 20160629T101459Z Authorization
时间、数量及其它自定义维度,如:按时间+版本2个维度计费,按版本+用户数+时间3个维度计费。 发布SaaS类、人工服务类、License类、硬件类和AI资产类商品规格时可使用多SKU定价。 多SKU定价规格发布规范 拟发布的商品如有不同版本、不同功能、不同模块、不同场景,应以规格