免费注册
帮助文档(华北一、二)

  • 1 适用对象

    云市场“SaaS外链接入类商品,适合哪些商品接入?

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

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

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

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

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

    文档简介

    本文档是云市场“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

     sortp1p2p3)不加入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:代表退订失败

     

     



文档是否已解决您的问题?

  已解决   未解决

如您有其它疑问,您也可以与我们技术专家联系探讨。

联系技术专家