博云网SaaS产品ISV接口文档

博云网SaaS产品ISV接入指南博云网SaaS产品ISV接入指南版本日期：2011/5/1博云网SaaS产品ISV接入指南目录1.文档目的...................................................................................................................................................................32.接入提交项...............................................................................................................................................................33.接口开发与测试环境...............................................................................................................................................33.1.接口工作流程...................................................................................................................................................33.1.1.B/S结构.....................................................................................................................................................43.1.2.C/S结构....................................................................................................................................................53.2.接口工作内容及步骤.......................................................................................................................................63.2.1.B/S结构.....................................................................................................................................................63.2.2.C/S结构....................................................................................................................................................63.3.接口的定义及开发...........................................................................................................................................63.3.1.接口实现形式............................................................................................................................................63.3.2.接口消息格式............................................................................................................................................63.3.3.软件接口定义............................................................................................................................................83.4.配置文件说明.................................................................................................................................................113.5.软件试用流程.................................................................................................................................................11博云网SaaS产品ISV接入指南1.文档目的本文档用于帮助ISV了解其产品接入平台时需要进行哪些工作、如何进行这些工作、完成后如何进行测试等，ISV在开始接入工作前，请详细阅读此文档内容。2.接入提交项提交项重要程度描述数据同步接口访问地址必需用户购买及添加子账户以及账户操作时同步信息的接口地址产品系统访问地址必需用户使用软件时跳转的地址接口密钥必需接口加密密钥，测试环境使用默认1234567890，上线时重新设定产品试用地址建议用户试用产品所跳转的地址产品试用账号一般用户试用产品登录所需账号产品试用密码一般用户试用产品登录所需密码3.接口开发与测试环境3.1.接口工作流程博云网SaaS产品ISV接入指南3.1.1.B/S结构用户博云网SaaS软件购买软件调用数据同步接口发送软件授权指令数据处理，开通系统返回处理结果授权使用用户调用数据同步接口发送用户授权指令数据处理，添加用户返回处理结果（对用户的一些操作）调用数据同步接口发送操作指令数据处理，修改用户返回处理结果用户点击使用软件按钮跳转到使用软件鉴权接口进行反向用户鉴权调用平台用户鉴权接口发送鉴权指令鉴权并返回返回处理结果收到结果直接进入软件使用或提示无权限使用说明：1、用户购买软件，支付完成后，我平台调用软件平台的数据同步接口，发送软件授权指令，将用户定制数据信息同步给软件平台2、购买用户给其它操作用户授权，我平台调用软件平台的数据同步接口，发送用户授权指令，将用户授权数据信息同步给软件平台3、用户使用软件的时候，在我平台登录后，点击软件的使用按钮，我平台跳转至软件平台的用户使用鉴权地址，并将软件及用户标示传递给软件平台，软件平台根绝用户信息，调用我平台的用户鉴权接口，进行用户身份验证，如果返回成功，则无需再次登录，直接跳转至软件平台内；如果返回失败，提示用户无权限使用。博云网SaaS产品ISV接入指南3.1.2.C/S结构用户博云网软件平台服务器端软件客户端购买软件调用数据同步接口发送软件授权指令数据处理，开通系统返回处理结果授权使用用户调用数据同步接口发送用户授权指令数据处理，添加用户返回处理结果（对用户的一些操作）调用数据同步接口发送操作指令数据处理，修改用户返回处理结果客户端选择博云网平台使用调用平台用户鉴权接口发送鉴权指令登录软件鉴权并返回返回处理结果收到结果直接进入软件使用或提示无权限使用说明：1、用户购买软件，支付完成后，我平台调用软件服务端平台的数据同步接口，发送软件授权指令，将用户定制数据信息同步给软件服务端平台2、购买用户给其它操作用户授权，我平台调用软件服务端平台的数据同步接口，发送用户授权指令，将用户授权数据信息同步给软件服务端平台3、用户使用软件的时候，在客户端选择所在平台（博云网），输入账号登录，软件服务端收到客户端登录请求，调用我平台的用户鉴权接口，进行用户身份验证，如果返回成功，则直接进入软件平台内；如果返回失败，提示用户无权限使用。博云网SaaS产品ISV接入指南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.请求消息请求消息是指调用接口的一方发出的消息，博云网SaaS产品ISV接入指南3.3.2.1.1.消息头Version=1&code={0}&tid={1}&appid={2}&requesttime={3}&authcode={4}所有接口的请求消息的消息头格式相同，具体属性说明见下表：名称说明数据类型长度（字节）Code操作码String4TID序列号，唯一标识一次业务动作StringAppID业务应用标识（标识是哪个ISV应用软件，在录入资源的时候由平台统一分配）StringRequestTime请求时间，14位String14Version版本号（保留字段）当前值:1StringAuthCode校验码MD5(TID+RequestTime+ISV密码)String323.3.2.1.2.消息体每一个接口的请求消息的消息体的格式各不相同，具体请参见各接口的详细消息格式说明。3.3.2.2.消息体加密处理消息体的原始数据为一段字符串，在消息传输时，消息体需要加密后传输，即消息的Body部分为加密后的字符串。消息加解密调用我平台提供的加解密接口。3.3.2.3.返回消息返回消息是指接口被调用的一方返回的消息。成功返回：SUCCESS失败返回：Err：错误编码（错误编码定义如下表）博云网SaaS产品ISV接入指南错误编码定义：CodeResultCodeResultMessage描述通用1001网络传输错误Post发送或接受数据失败1002参数不完整无参数或参数个数不对1003身份不合法无法获取接口密码接口校验及加解密1011参数不正确时间格式不对1012接口已失效接口已超时1013校验失败校验码不正确1014加密体加密失败1015加密体解密失败1016参数不完整Msg参数为空无加密体定制1021Sp数据处理错误授权1031Sp数据处理错误鉴权1041数据内部错误1042用户不合法3.3.3.软件接口定义博云网SaaS产品ISV接入指南3.3.3.1.软件授权接口用户购买软件，支付完成后，我平台调用此接口将用户定制数据信息同步给软件平台消息类型编码1001请求消息消息格式Version=1&code={0}&tid={1}&appid={2}&requesttime={3}&authcode={4}&msg=加密消息体未加密的消息体格式optype={0