博云网SaaS产品ISV接口

目录
1.文档目的 (3)
2.接入提交项 (3)
3.接口开发与测试环境 (3)
3.1.接口工作流程 (3)
3.1.1.B/S结构 (4)
3.1.2.C/S 结构 (5)
3.2.接口工作内容及步骤 (6)
3.2.1.B/S结构 (6)
3.2.2.C/S 结构 (6)
3.3.接口的定义及开发 (6)
3.3.1.接口实现形式 (6)
3.3.2.接口消息格式 (6)
3.3.3.软件接口定义 (8)
3.4.配置文件说明 (11)
3.5.软件试用流程 (11)
1.文档目的
本文档用于帮助ISV了解其产品接入平台时需要进行哪些工作、如何进行这些工作、完成后如何进行测试等，ISV在开始接入工作前，请详细阅读此文档内容。

2.接入提交项
3.接口开发与测试环境
3.1.接口工作流程
用户博云网SaaS软件
说明：
1、用户购买软件，支付完成后，我平台调用软件平台的数据同步接口，发送软件授权指令，将用户定制数据信息同步给软件平台
2、购买用户给其它操作用户授权，我平台调用软件平台的数据同步接口，发送用户授权指令，将用户授权数据信息同步给软件平台
3、用户使用软件的时候，在我平台登录后，点击软件的使用按钮，我平台跳转至软件平台的用户使用鉴权地址，并将软件及用户标示传递给软件平台，软件平台根绝用户信息，调用我平台的用户鉴权接口，进行用户身份验证，如果返回成功，则无需再次登录，直接跳转至软件平台内；如果返回失败，提示用户无权限使用。

说明：
1、用户购买软件，支付完成后，我平台调用软件服务端平台的数据同步接口，发送软件授权指令，将用户定制数据信息同步给软件服务端平台
2、购买用户给其它操作用户授权，我平台调用软件服务端平台的数据同步接口，发送用户授权指令，将用户授权数据信息同步给软件服务端平台
3、用户使用软件的时候，在客户端选择所在平台（博云网），输入账号登录，软件服务端收到客户端登录请求，调用我平台的用户鉴权接口，进行用户身份验证，如果返回成功，则直接进入软件平台内；如果返回失败，提示用户无权限使用。

3.2.接口工作内容及步骤
条件：注册成为博云网商家，激活账号并发布了软件产品
3.2.1.B/S结构
1、新增数据同步接口，实现数据信息的同步接收及处理；
2、去除现有软件的登录部分；
3、新增软件使用的跳转地址，并开发反向用户鉴权功能。

3.2.2.C/S 结构
1、服务器端新增数据同步接口，实现数据信息的同步接收及处理；
2、修改客户端，增加平台选项，让用户选择用户来源；
3、服务器端修改用户登录认证，判断如果选择是博云网平台的用户，调用我平台提供的用户鉴权接口，进行用户鉴权认证。

3.3.接口的定义及开发
3.3.1.接口实现形式
目前数据同步和用户鉴权接口均采用Http 发送Post 请求的方式传递数据
软件使用采用url跳转的方式
3.3.2.接口消息格式
3.3.2.1.请求消息
请求消息是指调用接口的一方发出的消息，
3.3.2.1.1.消息头
Version=1&code={0}&tid={1}&appid={2}&requesttime={3}&authcode={4}
所有接口的请求消息的消息头格式相同，具体属性说明见下表：
3.3.2.1.2.消息体
每一个接口的请求消息的消息体的格式各不相同，具体请参见各接口的详细消息格式说明。

3.3.2.2.消息体加密处理
消息体的原始数据为一段字符串，在消息传输时，消息体需要加密后传输，即消息的Body部分为加密后的字符串。

消息加解密调用我平台提供的加解密接口。

3.3.2.3.返回消息
返回消息是指接口被调用的一方返回的消息。

成功返回： SUCCESS
失败返回：Err：错误编码（错误编码定义如下表）
错误编码定义：
3.3.3.软件接口定义
3.3.3.1.软件授权接口
用户购买软件，支付完成后，我平台调用此接口将用户定制数据信息同步给软件平台
3.3.3.2.用户授权
购买用户给其它操作用户授权，我平台调用此接口将用户授权数据信息同步给软件平台
3.3.3.3.产品访问鉴权接口
用户使用软件的时候，软件平台调用此用户鉴权接口，进行用户身份验证
B/S 模式
1、用户在我平台点击使用软件按钮，跳转链接至产品使用接口地址（例如：
http://***.***.***/ sp_usesoft.aspx? sid={0}&pid={1}&uid={2}&tid={3}&sign={4}）
2、产品使用页面post 数据sid={0}&pid={1}&uid={2}&tid={3}&sign={4}至
http://202.85.223.69/ISV_Test/ISVInterface_useauc.ashx（测试地址，正式地
址在正式接入时提供）
3、根据返回结果直接跳转至软件使用
C/S模式
1、客户端登录时，服务器端post 数据sid={0}&pid={1}&uid={2}&tid={3}&sign={4}至
http://202.85.223.69/ISV_Test/ISVInterface_useauc.ashx（测试地址，正式地址
在正式接入时提供）
2、根据返回结果返回给客户端是否成功登录
3.4.配置文件说明
<add key="saasurl"value="http://202.85.223.69/ISV_Test/ISVInterface_useauc.ashx"/>
用户反向鉴权接口测试地址，正式地址接入时提供
<add key="encodeurl"value="http://202.85.223.69/ISV_Test/isvencode.ashx"/>
数据传输加解密测试地址，正式地址接入时提供
<add key="domain"value="http://124.126.239.33/net/"/>
接口程序的访问地址路径
<add key="spkey"value="1234567890"/>
接口传输密钥，测试默认1234567890，正式由软件方设定
3.5.软件试用流程
在我平台的软件（资源）管理界面里，输入该软件的测试地址和测试账号、测试密码，在软件展示页里，点击试用按钮，我平台生成链接并跳转至试用地址，格式为http://提供的试用地址?sid={0}&pid={1}&uid={2}&passwd={3}。