接口说明

最近更新时间:2020-07-09 15:53:36

一、SaaS商品接入前提

服务商发布SaaS商品时,需要按照云市场提供的生产接口规范进行生产接口开发(商品发布过程中需要填写接口的生产地址)。在用户购买、续费、退订等动作完成之后,云市场通过调用服务商提供的生产地址,通知服务商实施购买、续费、关停等动作,动作完成后返回给云市场相关信息。

说明:
1.同一个商品发布时,针对不同的调用场景(新购、续费、过期、回收和升级),只需要配置一个“生产系统接口地址”。
2.生产接口开完完成后可以使用在线调试工具进行调试,调试通过后方可发布SaaS商品。

二、接口说明

1.新购资源

客户购买商品并付款成功,云市场将调用本接口(新购场景)通知服务商客户购买商品的信息和客户信息,商品生产环境收到该请求信息,需执行新购对应动作并将执行结果返回给云市场。

说明:
1.新购资源时,服务商在处理接口时,需要做好幂等性处理,可用订单ID作为幂等标识。针对同一订单号,应当返回成功的响应及实例信息,不应该创建新的SaaS实例,返回之前成功创建的实例信息即可。
2.请不要阻塞此接口,如果耗时较长(处理时长超过10秒),建议使用队列做缓冲处理,设置instanceId=0,然后立即返回。若操作失败也请设置instanceId=0,云市场会再次调用,直到获取到instanceId。若资源开通失败,平台会自动退款给客户。
3.若商品单月因接口失败导致的失败订单超过5个,云市场将对该商品下架处理。

2.续费资源

客户续费下单或试用商品转正付款成功后,云市场将调用该接口(续费场景)请求服务商执行业务延期,服务商接口需要执行将到期日进行更新,并将执行结果返回给云市场。

3.升级资源

客户对已购买的商品升级下单且付款成功后,云市场将调用该接口(升级场景)请求服务商执行升配,服务商接口需要执行将商品进行升配,并将执行结果返回给云市场。

4.冻结资源

客户购买的商品过期时,云市场调用该接口(过期场景),服务商接到该通知以后应该将指定的实例冻结,并将执行结果返回给云市场。

包年包月的实例有保留期,实例到期后,保留7 天,云市场会在实例到期(2019-10-01 23:59:59)后第7天零点(2019-10-08 00:00:00)发送回收资源消息。

5.回收资源

当客户已购买的商品到期不续订且超过冻结期、或申请退订商品成功时,云市场将释放客户购买的商品并调用该接口(回收场景),服务商接收到该通知以后删除指定的实例,并将执行结果返回给云市场。

金山云,开启您的云计算之旅

免费注册