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

6 出租屋信息管理系统二期 接口文档 V1.0 接口定义 说明 为了方便接口的统一和方便的使用，所有功能都采用两个固定接口来实现，通过功能标识（CMD）来区别不同的业务请求 接口类型 WebService 接口。 此接口由中大《出租屋信息管理系统》提供，灵动《出租屋信息管理系统二期》调用。 接口原型 接口一： /// summary /// 所有功能集中在一个接口里，通过CMD区别是实现什么功能 /// /summary /// param name=loginId登录帐号/param /// param name=password登录密码/param /// param name=CMD用于区别实现什么功能的命令字/param /// param name=XMLParams以XML组织的除登录名和密码之外的参数/param /// param name=image照片，没有为null/param /// returnsxml格式/returns public string PDAInterfaceXML(string loginId,string password,string CMD, string XMLParams, byte[] image) { return xmlstring; } 接口二： /// summary /// 根据URL取得照片 /// /summary /// param name=loginId登录帐号/param /// param name=password登录密码/param /// param name=imageurl照片的URL地址，相对路径，就是数据库中保存的路径/param /// returns照片，没有为null /returns public byte[] PDAGetimage(string loginId,string password,string imageurl) { return image; } 参数说明 接口一： CMD：为业务请求标识，根据标识的不同，实现不同的功能。 XMLParams：不同的业务请求具有不同的参数，除登录名和密码之外的所有的参数以XML组织封装，都为string类型，结构如下： CDATA param1 description=” 参数名,根据不同的参数有不同的名称,如userid、password等”XXX/param1 param2 description=” 此参数的值”XXX/param2 …… /CDATA Image：人员照片,没有时为null。 接口二： Imageurl：照片的URL地址，相对路径，就是数据库中保存的路径 返回值说明 接口一： 以XML组织的返回，结构与参数类似，不同的请求具有不同的子节点： CDATA param1 description=” 此节点说明”XXX/param1 param2 description=” 此节点说明”XXX/param2 /CDATA 接口二： 返回byte[]型。 接口一和二的详细请求与返回值 此接口中所有下接框（数据字典）的值，传递时都只传主键，不传中文。 测试网络 说明：测试PDA与市办服务器网络是否连接正确 调用接口：PDAInterfaceXML CMD命令字：Test 参数：CDATATestCDATA 返回值：CDATAOKCDATA 用户登录 说明：验证用户合法性 调用接口：PDAInterfaceXML CMD命令字：Login 参数： CDATA loginid description=帐号admin/loginid password description=密码1234/password /CDATA 返回值：XML CDATA success description=登录是否成功，1为成功，0为失败1/success errmsg description=错误信息/errmsg username description= 用户姓名test/username carea description=服务管理中心虎门镇/carea careaid description=服务管理中心id1 /careaid czone description=服务站东山/czone czoneid description=服务站id2 /czoneid depttype description=用户类型