检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
公共响应消息头参数 表1 公共响应消息头 名称 描述 示例 Date HTTP协议标准报头。表示消息发送的时间,时间的描述格式由rfc822定义。 Mon, 12 Nov 2007 15:55:01 GMT Server HTTP协议标准报头。包含了服务器用来处理请求的软件信息。
接口安全令牌 在云商店发布License类授权码商品时,商家需要开发生产接口与云商店平台对接,根据接口规则实现相关的接口定义。用户在云商店对购买License商品续费、退订后,云商店会回调商家实现的生产接口来更新授权码状态,从而为用户使用的License商品统一进行生命周期管理。
APIGW网关错误码 APIGW网关错误码请参考《错误码》。 父主题: 接口使用方法
HTTP Body签名 基础接口HTTP Body签名 定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature,并且将signature通过URL PARAMS的方式添加到URL上,商家在接收到请求后需要同样的规则对请求体进行重新计算signature,并且与
创建实例 接口说明 客户购买商品并付款成功,云商店将调用本接口通知商家创建实例 商家需要返回此订单的唯一ID(instanceId)。建议此ID直接使用该订单首次请求时云商店传入的businessId,以确保instanceId的唯一性。 在正常购买场景中,请不要阻塞此接口,如果
企业同步 接口说明 买家购买联营SaaS商品后,登录到华为云买家中心控制台,将应用与企业绑定时,云商店调用该接口请求商家同步该企业的租户信息,商家接口需要执行租户同步,保存租户信息,并返回通知云商店。 针对企业同步场景接口调用失败的情况,由买家选择是否重试,并用短信或邮件的形式通知商家接口调用失败。
联营SaaS类商品接入流程介绍 联营SaaS类商品接入云商店概览: 如上图所示,联营SaaS接入分成为2个阶段: Kit对接:商家根据业务所需进行接口调试(参考1.4基础接口描述和1.5联营kit接口描述); 账号测试:商家在云商店的“卖家中心”进行1.8 接口调试,1.6 应用凭证申请,并获取应用测试账号,完成1
用户授权同步 接口说明 管理员被授权管理某企业后,登录到华为云买家中心控制台,对企业内用户授权该企业已绑定的应用,云商店异步调用该接口请求商家同步该企业应用的用户授权信息,商家接口需要执行授权信息同步,保存用户授权信息,并返回通知云商店。 针对用户授权同步场景接口调用失败的情况,
系统、数据库中间件、应用软件等license。 硬件类 硬件类商品是指将商家提供的华为云云商店解决方案相关的硬件设备作为商品,包括如IoT开发模组、接入终端等硬件设备。 AI资产类 AI资产类商品是指商家基于ModelArts等AI平台或本地开发得到的算法、模型、工程等AI数字资
出现在商品名称中。 如发布的是HCS版商品,请命名为“XXX(HCS版)”。 商品版本 商品版本命名应符合规范,建议使用“V1.0”“V2.0”形式命名,不能使用“v0.1”非正式版本或“第1个版本”、“初始版本”这类不规范命名。 商品Logo 支持png格式,图片尺寸为120*120px,图片大小不超过5M。
公共请求消息头参数 表1 公共请求消息头 名称 描述 是否必选 示例 x-sdk-date 请求的发生时间,格式为:yyyyMMdd'T'HHmmss'Z'。 取值为当前系统的GMT时间。 否 使用AK/SK认证时必选 20160629T101459Z Authorization
错误码 公共错误码 表1 错误码 http状态码 error_code error_msg 描述 200 92020000 Success 成功 200 92020001 internal error 其它服务内部错误 200 92020002 invalid param 请求参数不合法
商家接入接口说明 商家发布License授权码商品时,需在生产接口服务器开发一个生产接口。 同一个商品发布时,针对不同的调用场景(续费、过期、释放),只需要配置一个“生产系统接口地址”。 客户续费下单付款成功后,云商店将调用该接口(续费场景)请求商家执行业务延期,商家接口需要更新到期日,并将执行结果返回给云商店。
生成AK、SK 注册并登录云商店,点击云商店首页右上角的“卖家中心”,进入卖家中心后台。 点击卖家中心左上角的“控制台”,进入管理控制台。 单击页面右上角的用户名,在下拉列表中单击“我的凭证”,进入“我的凭证”页面。 单击页面左侧导航中的“管理访问密钥”,进入“访问密钥”页面。
登录场景:accesstoken续期 用户登录获得的access_token有效期默认为2小时,refresh_token刷新令牌有效期默认为30天,在用户持续访问应用的情况下,服务端应提供access_token的续期功能。 续期功能内部调用时序图: 接口URL请参考联营能力开放接口的刷新Access
登出场景:用户清理会话 用户在应用界面点击退出,此时应用需调用云商店的logout接口来完成服务端接口清理会话信息,对于商家服务上的会话清理,需要商家自行开发服务端接口供前端调用。以下提供示例接口供商家调用。 父主题: 联营账号基于WEB登录
请求认证说明 定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature,并且将signature通过URL PARAMS的方式添加到URL上,商家在接收到请求后需要同样的规则对请求体进行重新计算signature,并且与云商店传递的signature相比较,完全相同即为校验通过,通过URL
OAuth获取AccessToken 用于web端OAuth登录认证场景,用户登录获得临时凭证后,SaaS服务器用临时凭证换取用户会话token。 URI POST /api/v1/oauth2/token 请求参数 表1 FormUrlEncoded参数 参数 是否必选 参数类型
联营账号登录流程 云商店联营SaaS的登录流程有二种: 1、联营SaaS采用独立的客户端(APP端集成云商店H5统一登录页)、独立的WEB页面方式登录; 2、联营SaaS采用开天aPaaS(如:IMC平台)的统一登录方式,商家根据自身需求,可以选择适合自己应用的登录方式,每种登录方式需要调测不同的接口。
查询订单 功能介绍 云商店商家可通过该接口查询订单所有信息 URI GET : https://mkt.myhuaweicloud.com/api/mkp-openapi-public/global/v1/order/query 参数说明请参见表1 响应参数。 仅支持https协议。