接口说明

接口调用场景

1. 创建实例：客户购买商品并付款成功。
   • 云商店将调用创建实例接口通知商家根据订单号创建实例。
   • 商家系统收到该请求信息，需调用云商店查询订单接口，获取本次订购的相关信息，执行新购对应动作。
2. 更新实例：客户试用转正、续费、退续费。
   • 云商店将调用更新实例接口，通知商家系统对相应资源变更过期时间，商家本地系统需执行相应动作，并将执行结果返回给云商店。
3. 更新实例状态：用户资源实例因到期、违规等情况下会对用户的实例进行冻结，同时在用户续费后，或资源解除违规后会对用户的实例进行解锁。
   • 云商店将调用更新实例状态接口，通知商家系统对相应资源执行冻结、解冻操作，并将执行结果返回给云商店。
   

   用户订单到期后，有 15天的资源冻结期，冻结期内资源不可使用，但可以对此订单续费以解冻继续使用，故商家需对在线开通License商品设置15天的冻结期，并在冻结期内保留用户数据。

4. 释放实例：用户释放购买产品的实例时（到期不续费、退订等场景）。
   • 云商店将调用释放实例接口，通知商家系统对相应资源执行释放操作，并将执行结果返回云商店。

接口失败场景及重试机制

当接口响应失败时，系统会邮件通知到商家云商店账号绑定的邮箱，“卖家中心 > 生产接口消息”中可查询接口“异常信息”，商家收到通知后须尽快处理接口异常，避免订单失败退订。

1. 针对创建实例接口调用失败的情况

   云商店会持续调用2小时（每2分钟1次）后停止调用，每失败1次发送通知。期间商家可在“卖家中心 > 生产接口消息”页面单击对应订单右侧操作栏的“重新启动”进行手动重试，若商家接口问题在3小时调用后仍未解决，系统则判断订单为失败，并自动进行订单退订。

2. 针对更新实例接口调用失败，云商店会持续调用2小时后停止调用，“卖家中心 > 生产接口消息”中可查询接口“异常信息”，请在修复接口异常后，自行在“卖家中心 > 生产接口消息”页面中查询接口“异常信息”，单击右侧操作栏的“重新启动”进行手动重试。
3. 针对更新实例状态接口调用失败，云商店会持续调用2小时后停止调用，“卖家中心 > 生产接口消息”中可查询接口“异常信息”，请在修复接口异常后，自行在“卖家中心 > 生产接口消息”页面中查询接口“异常信息”，单击右侧操作栏的“重新启动”进行手动重试。

• 接口响应失败将通过邮件、短信、站内信进行通知，请注意关注账号绑定的邮箱、手机短信及站内信的相关通知。

• 如果商品单月因接口失败导致的失败订单超过5个或者长时间拨测失败，云商店将对该商品下架处理。

• 因接口响应失败导致自动退订的订单，请商家及时联系用户进行沟通，避免造成用户投诉。

• 如因接口响应失败，导致用户过期后仍能正常使用所造成的资源损失，由商家自行承担。