出租屋信息管理系统二期接口文档.doc

出租屋信息管理系统二期接口文档V1.01 接口定义1.1 说明为了方便接口的统一和方便的使用，所有功能都采用两个固定接口来实现，通过功能标识（CMD）来区别不同的业务请求1.2 接口类型WebService 接口。此接口由中大出租屋信息管理系统提供，灵动出租屋信息管理系统二期调用。1.3 接口原型接口一： / / 所有功能集中在一个接口里，通过CMD区别是实现什么功能 / / 登录帐号 / 登录密码 / 用于区别实现什么功能的命令字 / 以XML组织的除登录名和密码之外的参数 / 照片，没有为null / xml格式 public string PDAInterfaceXML(string loginId,string password,string CMD, string XMLParams, byte image) return xmlstring;接口二： / / 根据URL取得照片 / / 登录帐号 / 登录密码 / 照片的URL地址，相对路径，就是数据库中保存的路径 / 照片，没有为null public byte PDAGetimage(string loginId,string password,string imageurl) return image;1.4 参数说明接口一：CMD：为业务请求标识，根据标识的不同，实现不同的功能。XMLParams：不同的业务请求具有不同的参数，除登录名和密码之外的所有的参数以XML组织封装，都为string类型，结构如下：XXXXXXImage：人员照片,没有时为null。接口二：Imageurl：照片的URL地址，相对路径，就是数据库中保存的路径1.5 返回值说明接口一：以XML组织的返回，结构与参数类似，不同的请求具有不同的子节点：XXXXXX接口二：返回byte型。2 接口一和二的详细请求与返回值此接口中所有下接框（数据字典）的值，传递时都只传主键，不传中文。2.1 测试网络l 说明：测试PDA与市办服务器网络是否连接正确l 调用接口：PDAInterfaceXMLl CMD命令字：Testl 参数：Testl 返回值：OK 2.2 用户登录l 说明：验证用户合法性l 调用接口：PDAInterfaceXMLl CMD命令字：Loginl 参数：admin1234l 返回值：XML 1test虎门镇1 东山2 2.3 出租屋登记与修改l 说明：登记新出租屋 l 调用接口：PDAInterfaceXMLl CMD命令字：HouseInsertl 参数: 1张三 l 返回值:XML0 不具备操作权限2.4 出租屋简要信息查询l 说明：通过组合查询条件，查询符合条件的所有出租屋列表，返回多条记录l 调用接口：PDAInterfaceXMLl CMD命令字：HouseSelectl 参数: 150l 返回值:XML没有权限:0不具备权限 0没有记录:1 0有记录时：1 1001HBO1234432452345345东城XXXXX张三02.5 出租屋详细信息查询l 说明：通过房屋租赁证号，查询此出租屋详细信息，只返回一条记录 l 调用接口：PDAInterfaceXMLl CMD命令字：HouseSelectMorel 参数: l 返回值:DataSet没有权限:0不具备权限 没有记录:1不具备权限 有记录时：1 1张三 2.6 出租屋删除（注销）l 说明：删除（注销）出租屋 l 调用接口：PDAInterfaceXMLl CMD命令字：HouseDeletel 参数: l 返回值:XML1 2.7 出租屋动态信息添加与修改l 说明：登记重点户动态信息 l 调用接口：PDAInterfaceXMLl CMD命令字：HouseDTInsertl 参数: l 返回值:XML1 2.8 出租屋动态信息查询l 说明：查询动态信息，返回多条记录 l 调用接口：PDAInterfaceXMLl CMD命令字：HouseDTSelectl 参数: l 返回值:XML没有权限:0不具备权限 0没有记录:10有记录时：1 100 2.9 出租屋动态信息详细信息查询l 说明：查询某一条动态信息的详细信息，返回一条记录 l 调用接口：PDAInterfaceXMLl CMD命令字：HouseDTSelectMorel 参数: l 返回值:XML没有权限:0不具备权限 没有记录:1 有记录时：1 1 2.10 人员 (包含同住人) 登记与修改l 说明：登记新莞人 l 调用接口：PDAInterfaceXMLl CMD命令字：PersonInsertl 参数: l 返回值:XML1 2.11 人员简要信息查询l 说明：通过组合查询