接口调用范例.DOCVIP

第一部分 接口调用规范 1.1 接口访问地址 外挂系统请求服务的接口访问地址： 2/web/WebService.asmx?wsdl 1.2 接口调用函数 外挂系统请求服务平台的接口包括两类：查询类和写入类接口。查询类接口对外提供查询服务，写入类接口对外提供将业务数据写入综合应用平台业务库。 1.2.1 查询类接口 public StringqueryObjectOut(Stringxtlb,String jkxlh,String jkid,String QueryXmlDoc); 表1：查询类接口调用参数说明 序号 参数说明 备注信息 xtlb 系统类别 接口提供者的业务类别代码，如机动车登记业务：01，驾驶证管理业务：02，违法处理：03，事故处理：04，交警队平台：10，剧毒品业务：06 jkxlh 接口序列号 由外挂系统请求服务平台授权生成下发 jkid 接口标识 5位，由系统类别＋一位级别代码＋两位接口顺序号组成(参照监管系统)，C：支队、B:总队，A：部局。如01A01代表机动车部局端提供的接口。定义时查询类接口顺序号取50以内的数字，写入接口顺序号定义为50以上的数字。 QueryXmlDoc 查询条件 封装查询条件的XML格式文档 1.2.2 写入类接口 Public String writeObjectOut (String xtlb,String jkxlh,String jkid;String WriteXmlDoc) 表2 写入类接口调用参数说明 序号 参数说明 备注信息 xtlb 系统类别 同上 jkxlh 接口序列号 同上 jkid 接口标识 同上 WriteXmlDoc 写入数据 业务数据写入XML格式文档 1.3 XML文件格式定义 1.3.1 查询类接口XML文档 查询条件QueryXmlDoc的文档格式要求如下： 查询返回结果XML文档格式 1.3.2 写入类接口XML文档 写入数据WriteXmlDoc文档格式如下： 写入操作返回结果文档格式如下： 1.4 调用注意事项 1.4.1 XML文档的中文处理 （1）接口查询结果进行过URLDecoder和UTF-8编码处理,须进行转换（转换函数为URLDecoder.decode(str, utf-8);）才能正常读取； （2）写入信息中文字符必须URLEncoder成utf-8格式（转换函数为URLEncoder.encode(xmlDoc, utf-8)；）后再封装成XML文档。 （3）XML文档的【写入数据字段】和【返回结果字段】的标签均为小写字符。XML文档【节点标签】必须和手册中注明的保持一致。 1.4.2返回结果错误代码说明 正常返回结果code为成功与否标记（0、失败；1、成功）写入失败时的详细描述信息。  读取机动车全项信息 接口标识：01C21 功能说明：根据输入号牌种类HPZL和号牌号码HPHM信息查询机动车全项信息VEHICLE表数据。 处理过程：①接口输入参数通过数据的逻辑校验；②通过统一软件提供的接口查询相关的机动车业务信息。 查询文档QueryXmlDoc说明：节点标签QueryCondition，查询条件数据字段如下表： 序号 参数项 名称 类型 长度 是否可空 备注 1 hpzl 号牌种类 CHAR 2 2 hpzm 号牌号码 VARCHAR2 15 不包含号牌号码中的汉字如“苏”、“警”、“挂”等 返回结果文档ResultXML说明：节点标签veh，查询结果数据字段如下表： 序号 参数项 名称 类型 长度 是否可空 备注 1 xh 机动车序号 CHAR 14 2 hpzl 号牌种类 CHAR 2 3 hphm 号牌号码 VARCHAR2 15 4 clpp1 中文品牌 VARCHAR2 32 5 clxh 车辆型号 VARCHAR2 32 6 clpp2 英文品牌 VARCHAR2 32 7 gcjk 国产/进口 CHAR 1 8 zzg CHAR 3 9 zzcmc 制造厂名称 VARCHAR2 64 10 clsbdh 车辆识别代号 VARCHAR2 25 11 fdjh 发动机号 VARCHAR2 30 12 cllx 车辆类型 CHAR 3 13 csys 车身颜色 VARCHAR2 5 14 syxz 使用性质 CHAR 1 15 sfzmhm 身份证明号码 VARCHAR2 18 16 sfzmmc 身份证明名称 CHAR 1 17 syr 机动车所有人 VARCHAR2 128 18 syq 所有权 CHAR 1 19