更新实例状态 接口说明 用户购买按周期计费商品后,对应的资源实例到期、违规等场景,云商店调用该接口,商家将指定的实例冻结。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如SaaS商品频繁出现因
tenantId M String(64) 租户ID,与租户同步接口的租户ID是一致的 appId M String(64) 应用的ID,云商店应用凭证中的应用ID clientId M String(64) 客户端id,是认证中心统一返回的ClientID clientSecret M String
创建实例 接口说明 客户购买商品并付款成功,云商店将调用本接口通知商家创建实例 商家需要返回此订单的唯一ID(instanceId)。建议此ID直接使用该订单首次请求时云商店传入的businessId,以确保instanceId的唯一性。 在正常购买场景中,请不要阻塞此接口,如果
商家的服务器在处理接口请求时,需要做好幂等性处理。 对于同一个实例,相同的租户要支持多次请求新增,或者删除,多次新增不应产生新的数据,且需要返回成功,如果是删除,多次删除也需要返回成功,不能因已删除返回失败,删除时不需要校验(创建实例)接口产生的实例是否存在。 租户同步流程如下图所示: 请求方法:POST
HTTP Body签名 基础接口HTTP Body签名 定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature,并且将signature通过URL PARAMS的方式添加到URL上,商家在接收到请求后需要同样的规则对请求体进行重新计算signature,并且与
请求消息 表1 请求参数 参数 是否必选 参数类型 最大字符长度 描述 license M String 64 授权码(新授权码对接商品传过来的是授权码,存量线上License商品也会调用该接口,传instanceId即可) heartbeatInfo M HeartbeatInfo 心跳检测信息
更新实例 接口说明 按周期售卖的商品,用户试用转正、续费、退续费后,云商店调用该接口,更新实例的到期日期。 用户进行商品转正、续费下单或退订续费周期后,云商店将调用该接口请求商家执行业务变更,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障更新实例接口通畅,如调
OAuth登出 用于web端OAuth登录认证场景,用户登出。 URI GET /api/v1/logout 请求参数 表1 Query参数 参数 是否必选 参数类型 描述 redirect_url 否 String 注销退出后的重定向地址,不设置则跳转登录页,注意需要进⾏URL
通用和自服务SaaS类商品接入流程介绍 通用和自服务SaaS类商品接入云商店的详细流程如下图所示: 流程说明如下: 申请入驻云商店,成为商家。 云商店运营人员审核公司的资质信息。 准备生产接口服务器,根据本接入指南开发生产接口(基础接口). 在卖家中心调试生产接口。 在卖家中心申请发布SaaS商品。
错误码 公共错误码 表1 错误码 http状态码 error_code error_msg 描述 200 92020000 Success 成功 200 92020001 internal error 其它服务内部错误 200 92020002 invalid param 请求参数不合法
mkt.myhuaweicloud.com或mkt.myhuaweicloud.cn Content-type 发送的实体的MIME类型。 是 application/json 下载签名工程示例代码后,HttpClientDemo类构建request请求,其中部分参数需要根据实际待调用接口做调整:
接口安全令牌 在云商店发布License类授权码商品时,商家需要开发生产接口与云商店平台对接,根据接口规则实现相关的接口定义。用户在云商店对购买License商品续费、退订后,云商店会回调商家实现的生产接口来更新授权码状态,从而为用户使用的License商品统一进行生命周期管理。
公共响应消息头参数 表1 公共响应消息头 名称 描述 示例 Date HTTP协议标准报头。表示消息发送的时间,时间的描述格式由rfc822定义。 Mon, 12 Nov 2007 15:55:01 GMT Server HTTP协议标准报头。包含了服务器用来处理请求的软件信息。
APIGW网关错误码 APIGW网关错误码请参考《错误码》。 父主题: 接口使用方法
应用凭证修改 当应用凭证已关联商品上架后,可以更新应用的生产接口地址、登录地址、公钥; 新的生产接口地址请确保已调测成功并保存,接口调试详情可参考1.8《接口调试》。 应用凭证修改操作步骤如下: 进入卖家中心页面,单击左侧导航的“应用工具>应用凭证管理>编辑”; 确定保存成功后,
nfo 请求参数 表1 请求Header 参数 是否必选 参数类型 描述 Accept 是 String 接收响应类型,值:application/json。 Authorization 是 String 认证凭据,值:Bearer {access_token}。 请求示例 GET
商家接入接口说明 商家发布License授权码商品时,需在生产接口服务器开发一个生产接口。 同一个商品发布时,针对不同的调用场景(续费、过期、释放),只需要配置一个“生产系统接口地址”。 客户续费下单付款成功后,云商店将调用该接口(续费场景)请求商家执行业务延期,商家接口需要更新到期日,并将执行结果返回给云商店。
联营账号基于开天aPaaS企业工作台登录 登录须知 oAuth2.0协议API CAS协议API 父主题: 联营kit账号登录接口描述
对于同一个实例,相同的租户,相同的应用,相同的userName,要支持多次请求新增,或者删除,多次新增不应产生新的数据,且需要返回成功,如果是删除,多次删除也需要返回成功,不能因已删除返回失败,删除时不需要校验(创建实例)接口产生的实例是否存在。 租户同步流程如下图所示: 请求方法:POST
等性处理。 对于同一个实例,相同的租户,相同的orgCode,要支持多次请求新增,或者删除,多次新增不应产生新的数据,且需要返回成功,如果是删除,多次删除也需要返回成功,不能因已删除返回失败,删除时不需要校验(创建实例)接口产生的实例是否存在。 部门增量同步 流程如下图所示: 请求方法:POST
您即将访问非华为云网站,请注意账号财产安全