1 适用对象

云市场“SaaS外链”接入类商品，适合哪些商品接入？

服务商的商品符合以下全部特点，即适合接入：

Ø  用户在云市场购买该商品后，交付给用户服务商的网站、用户名、默认密码；

Ø  用户可以通过服务商的网站，直接进行登录即可使用的软件；

Ø  属于在线应用类的软件，即业内一般称为“SaaS”软件；

Ø  用户无需将软件部署到独立的云资源上即可使用的软件；

2 文档简介

本文档是云市场“SaaS外链”商品接口开发的描述，服务商将商品接入到云市场平台售卖，需要服务商对接实现生产接口的开发。

当商品在云市场上架后，用户下单购买、续费时，云市场将购买的用户信息、商品信息、订单等通过调用服务商的生产接口，通知服务商对应执行，服务商将生产结果返回给云市场。

文档中涉及到的所有接口都以HTTP GET方式调用，消息传输以JSON格式。

该生产接口要求：

1、必须是http或者https开头；

2、在一个接口地址里实现所有生产行为（新购、续费、过期、释放）；

3、在商品上架期间，服务商要保障生产接口通畅，不然会导致业务失败。

3 接入前期准备

3.1  生成token的依赖

token值作为浪潮云市场与服务商之间进行安全校验必有参数，云市场每次调用服务商接口的参数中都会带有token值。而token的生成依赖于浪潮云市场对每个服务商提供不同的key值。请联系浪潮运营人员（客服电话:0531-85105963 工作日8:30-17:00，邮箱:jiangfan@inspur.com）完成服务商在云市场的入住，入住完毕将提供相应的key值。

3.2  生成token的说明

1、说明：服务商根据生成规则生成token值，并与接口中获取的token值进行比较，两者完全相同即为校验通过。

2、生成规则：取所有的http get请求参数(排除token)，对参数名进行字典排序，在字符串的最后加上您的key，然后对整个字符串进行md5加密。

3、举例：

 服务商收到的调用请求数据示例：http://www.yourSaaSURL.com?p1=1&p2=2&p3=3&token=xxxx

 sort（p1，p2，p3）不加入token

 token生成：”p1=1&p2=2&p3=3&key=yourkey”.toMD5()。

4    商品订购

4.1  场景

云市场用户购买商品并付款成功，云市场将调用“商品订购”接口通知服务商购买商品的信息和用户信息。

4.2   入参

4.3   出参

5    商品冻结

5.1  场景

云市场在商品到期的当天调用‘商品冻结’接口，服务商接到该通知以后将指定的实例冻结。商品被冻结，即不允许该账号进行登录，但有7天账号保留的窗口期。

5.2  入参

5.3  出参

6    商品续费

6.1  场景

按周期售卖的商品，SaaS服务商必须实现续费接口。用户在云市场上续费后，云市场将调用服务商提供的‘商品续费’接口执行业务延期，服务商接口需要将业务到期日进行更新。

6.2  入参

6.3  出参

7   商品到期退订

7.1  场景

被冻结的商品如果用户7天内未续费，则云市场调用‘释放商品资源’，通知服务商删除指定的实例。

7.2  入参

7.3  出参