帮助文档（华北一、二）

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 入参

参数	必选项	类型及范围	说明
token	true	String	安全校验令牌
action	true	String	“createInstance“
orderId	true	String	云市场订单流水号
goodId	true	String	云市场商品ID SaaS商品在云市场上上线后，将生成该商品的ID。在接口对接时由浪潮侧提供该ID。
speId	true	String	商品规格ID 与商品唯一对应，一个商品可以有多个规格。用户在新购商品时，会选择一个商品规格进行购买。 SaaS商品在云市场上上线后，将生成该商品规格ID。在接口对接时由浪潮侧提供该ID。
expireddate	false	String	过期时间(yyyy-MM-dd HH:mm:ss) 如果是按周期售卖的商品，入参中会传递该参数；如果是按次售卖的商品，入参中不会传递该参数。
email	false	String	用户邮箱
mobile	false	String	用户手机

4.3 出参

参数	父节点	必选项	类型及范围	说明
instanceId	无	true	String	实例ID 服务商提供的订购商品的唯一标识
appInfo	无	true		appInfo字段是用户购买商品后，登录服务地址（网站地址）进行后续操作等的说明
url	appInfo	true	String	用户购买商品后，可以访问SaaS应用的地址
username	appInfo	true	String	帐号用户购买商品后，访问SaaS应用的账号：为邮箱或手机号
password	appInfo	true	String	密码用户购买商品后，访问SaaS应用的密码：为服务商生成

5 商品冻结

5.1 场景

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

5.2 入参

参数	必选项	类型及范围	说明
token	true	String	安全校验令牌
action	true	String	expiredInstance
instanceId	true	String	实例ID 服务商提供的订购商品的唯一标识

5.3 出参

参数

必选项

类型及范围

说明

success

true

Boolean

是否成功

true:代表冻结成功

false:代表冻结失败

6 商品续费

6.1 场景

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

6.2 入参

参数	必选项	类型及范围	说明
token	true	String	安全校验令牌
action	true	String	renewInstance
instanceId	true	String	实例ID 服务商提供的订购商品的唯一标识
expiredDate	true	DateTime	过期时间（yyyy-MM-dd HH:mm:ss）
orderId	true	String	云市场续费订单流水号

6.3 出参

参数

必选项

类型及范围

说明

success

true

Boolean

是否成功

true:代表续费成功

false:代表续费失败

7 商品到期退订

7.1 场景

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

7.2 入参

参数	必选项	类型及范围	说明
token	true	String	安全校验令牌
action	true	String	releaseInstance
instanceId	true	String	实例ID 服务商提供的订购商品的唯一标识

7.3 出参

参数

必选项

类型及范围

说明

success

true

Boolean

是否成功

true:代表退订成功

false:代表退订失败

云视频

视频监控

教育

医疗

食品

传媒

金融

交通

电商

物流

制造

印染

云ERP

1 适用对象

2 文档简介

3 接入前期准备

3.1 生成token的依赖

3.2 生成token的说明

4 商品订购

4.1 场景

4.2 入参

4.3 出参

5 商品冻结

5.1 场景

5.2 入参

5.3 出参

6 商品续费

6.1 场景

6.2 入参

6.3 出参

7 商品到期退订

7.1 场景

7.2 入参

7.3 出参