帮助文档（华北一、二）

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

参数	父节点	必选项	类型及范围	说明

最新活动

产品

解决方案

政务云

工业互联网

云市场

支持与服务

合作伙伴