检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
授权码心跳检测 功能介绍 商家进行授权码的激活后,用户每日首次使用License软件时,商家需要调用该接口,若不使用则无需调用。 URI POST https://mkt.myhuaweicloud.com/api/mkp-openapi-public/global/v1/license/heartbeat
更新授权码有效期 接口说明 包周期License商品实现续费、退续费场景下,商家通过该接口更新对应授权码有效期。 用户续费下单,云商店将调用该接口请求商家执行业务延期,商家接口需要更新到期日,并返回通知云商店。 商家需要保障接口通畅,执行业务延期,如续费失败,可能导致该授权码对应的资源被释放。
签名示例工程代码 签名示例工程代码请参考《AK/SK认证》。 父主题: 接口使用方法
请求签名流程 第三方应用对华为云API的访问需经过签名认证。签名过程及示例代码请参考开放接口示例代码。 示例代码中接口请求参数修改可参考下图: 父主题: 获取AK/SK认证
应用同步 接口说明 用户购买联营SaaS类应用后,登录到华为云买家中心控制台,将应用与企业绑定时,云商店调用该接口请求商家同步该企业应用的认证信息,商家接口需要执行应用同步,保存应用信息,并返回通知云商店。 针对应用同步场景接口调用失败的情况,由买家选择是否重试,并用短信或邮件的形式通知商家接口调用失败。
OAuth登出 用于web端OAuth登录认证场景,用户登出。 URI GET /api/v1/logout 请求参数 表1 Query参数 参数 是否必选 参数类型 描述 redirect_url 否 String 注销退出后的重定向地址,不设置则跳转登录页,注意需要进⾏URL
用户授权同步 接口说明 管理员被授权管理某企业后,登录到华为云买家中心控制台,对企业内用户授权该企业已绑定的应用,云商店异步调用该接口请求商家同步该企业应用的用户授权信息,商家接口需要执行授权信息同步,保存用户授权信息,并返回通知云商店。 针对用户授权同步场景接口调用失败的情况,
HTTP Body签名 基础接口HTTP Body签名 定义 云商店每次调用商家的接口时会根据一定规则对请求生成signature,并且将signature通过URL PARAMS的方式添加到URL上,商家在接收到请求后需要同样的规则对请求体进行重新计算signature,并且与
创建实例 接口说明 客户购买商品并付款成功,云商店将调用本接口通知商家创建实例 商家需要返回此订单的唯一ID(instanceId)。建议此ID直接使用该订单首次请求时云商店传入的businessId,以确保instanceId的唯一性。 在正常购买场景中,请不要阻塞此接口,如果
企业同步 接口说明 买家购买联营SaaS商品后,登录到华为云买家中心控制台,将应用与企业绑定时,云商店调用该接口请求商家同步该企业的租户信息,商家接口需要执行租户同步,保存租户信息,并返回通知云商店。 针对企业同步场景接口调用失败的情况,由买家选择是否重试,并用短信或邮件的形式通知商家接口调用失败。
更新实例状态 接口说明 用户购买按周期计费商品后,对应的资源实例到期、违规等场景,云商店调用该接口,商家将指定的实例冻结。 请及时关注商家信息中客服邮箱以及云商店账号绑定的邮箱的通知,收到调用失败通知邮件及时处理接口异常。 云商店会对接口异常的情况做监控,如SaaS商品频繁出现因
进入买家中心,点击“已购买服务”,在订单页面点击展开订单栏的“更多”,再点击“转商用”,进入下单页面。 在下单页面选择续费周期后,点击“去支付”。 选择支付方式后,点击“去在线支付”,完成订单支付即可。 父主题: 免费试用
查询实例信息 接口说明 商家创建完资源后,云商店根据instanceId查询资源实例的信息。 查询实例信息流程如下图所示: 请求方法:POST Body参数 参数 是否必选 类型 取值范围 说明 activity M String 20 接口请求标识,用于区分接口请求场景。 升级场景取值:queryInstance
订单通知 接口功能及说明 接口安全令牌 订单通知接口描述 接口调试 订单通知配置 父主题: 商品交易相关接口
组织部门信息同步(增量) 接口说明 管理员被授权管理某企业后,在买家中心登录,对管理的企业执行新建、编辑、删除部门操作时,云商店调用该接口,请求商家同步该企业的组织增量变更;商家接口需要执行增量组织信息同步,保存信息,并返回通知云商店。 商家的服务器在处理接口请求时,需要做好幂等性处理。
组织部门信息同步(全量) 接口说明 买家购买联营SaaS应用后,在买家中心登录,将应用与企业绑定时,云商店调用该接口请求商家同步该企业全量的组织信息,商家接口需要执行全量组织信息同步,保存组织信息,并返回通知云商店。 商家的服务器在处理接口请求时,需要做好幂等性处理。 对于同一个
错误码 公共错误码 表1 错误码 http状态码 error_code error_msg 描述 200 92020000 Success 成功 200 92020001 internal error 其它服务内部错误 200 92020002 invalid param 请求参数不合法
OAuth获取用户信息 用于web端OAuth登录认证场景,SaaS服务器换取用户token后,根据用户token获取用户基础信息。 URI GET /api/v1/oauth2/userinfo 请求参数 表1 请求Header 参数 是否必选 参数类型 描述 Accept 是
商品续费 接口说明 按周期售卖的商品,商家必须实现续费接口生产开发。 客户续费下单或试用商品转正后,云商店将调用该接口请求商家执行业务延期,商家接口需要执行将到期日进行更新,并返回通知云商店。 商家需要保障续费接口通畅,将业务进行延期,如续费失败,将可能导致用户的业务被释放的风险。
商品过期 接口说明 客户购买的商品过期时,云商店调用该接口,商家接到该通知以后应该将指定的实例冻结。 针对过期场景接口调用失败的情况,云商店会持续调用1小时后停止调用,“卖家中心>生产接口消息”中可查询接口“异常信息”,请在修复接口异常后,通知云商店partner@huaweicloud