智能一卡通管理系统6700平台SDKV2.0.0(平台部分)讲解.docx

平台SDK开发手册 平台SDK开发手册 非常感谢选择本公司产品，我们将竭诚为您提供最好的服务。 本手册内容将不定期更新，恕不另行通知；更新内容将在版本更新信息中给出。 如您对手册中的内容有疑惑或者有好的建议，请通过技术支持联系我们。 我们的进步需要您的宝贵意见。  简介 前提 第三方对外WebService接口是基于智能一卡通6700 (V2.0.0)版本，在使用接口前，请确认您已经安装好了该版本软件，并且已经成功运行。 WebService接口地址 接口地址采用统一的地址形式（如： HYPERLINK /services/ThirdSdkService /services/ThirdSdkService），具体以版本发布说明为准。 版本信息 版本号 日期 修订者 修改内容 1.0.0 2015-03-23 高嵩 创建  接口定义 用户接口定义 登录接口 接口名称： String userLogin (String xml) 接口描述：第三方用户登录接口 参数 参数名 参数描述 类型 必要字段 备注 userName 用户名 String Y userPwd 用户密码 String Y 已加密 ip 用户IP String Y port 用户端口 Integer Y 参数报文 root userName /userName userPwd/userPwd ip/ip port/port /root 返回值 参数名 参数描述 类型 备注 Xml参数 errorCode 错误码 Integer 错误码，为“0”代表成功，其他错误码请对照 HYPERLINK \l _错误码定义 错误码描述表查找。 result 结果是否正确 Boolean 返回结果，true代表成功,false代表失败。 sessionId 用户登录会话 String 用户成功登录后，返回的用户登录标记 返回报文 root head errorCode/errorCode result/result /head body item sessionId/sessionId /item /body /root 登出接口 接口名称： String userLogOut (String xml) 接口描述：用户登出接口 参数 参数名 参数描述 类型 必要字段 备注 sessionId 用户登录会话 String Y 用户成功登录后，返回的用户登录标记 参数报文 root sessionId/sessionId /root 返回值 参数名 参数描述 类型 备注 Xml参数 errorCode 错误码 Integer 错误码，为“0”代表成功，其他错误码请对照 HYPERLINK \l _错误码定义 错误码描述表查找。 result 结果是否正确 Boolean 返回结果，true代表成功,false代表失败。 返回报文 root head errorCode/errorCode result/result /head body/ /root 添加用户接口（仅支持单点登录对接版本，普通版本不支持） 接口名称： String? addUser (String xml) 接口描述：添加用户接口 参数 参数名 参数描述 类型 必要字段 备注 sessionId 用户登录会话 String Y 用户成功登录后，返回的用户登录标记 operId 操作者ID String Y ? loginAccount 登录名称 String Y admin用户不能添加 userName 用户名称 String Y endTime 有效结束时间 Long Y userDesc 用户描述 String N 参数报文 root operId /operId sessionId/sessionId items item loginAccountloginAccount userName/userName endTimeendTime userDescuserDesc /item …… ??? /items /root 返回值 参数名 参数描述 类型 备注 Xml参数 errorCode 错误码 Integer 错误码，为“0”代表成功，其他错误码请对照 HYPER