六合一综合平台-外挂系统接口使用手册

-1-交通管理综合应用平台外挂系统请求服务接口使用手册-2-目录第一部分接口调用规范.........................................................-3-1.1.接口访问地址...........................................................-3-1.2.接口调用函数...........................................................-3-1.2.1.查询类接口...........................................................-3-1.2.2.写入类接口...........................................................-4-1.3.XML文件格式定义.......................................................-4-1.3.1.查询类接口XML文档...................................................-4-1.3.2.写入类接口XML文档...................................................-5-1.4.调用注意事项...........................................................-5-1.4.1.XML文档的中文处理....................................................-5-1.4.2.返回结果错误代码说明.................................................-6-第二部分外挂系统接口说明.....................................................-7-1.接口说明...............................................................-7-2.接口列表...............................................................-7-2.1.机动车接口定义.........................................................-11--3-第一部分接口调用规范1.1.接口访问地址外挂系统请求服务的接口访问地址：其中IP标识Web服务器地址；port对应系统应用服务的端口号，启用80的不填写。1.2.接口调用函数外挂系统请求服务平台的接口包括两类：查询类和写入类接口。查询类接口对外提供查询服务，写入类接口对外提供将业务数据写入综合应用平台业务库。1.2.1.查询类接口publicStringqueryObjectOut(Stringxtlb,Stringjkxlh,Stringjkid,StringQueryXmlDoc);表1：查询类接口调用参数说明序号参数名称参数说明备注信息1xtlb系统类别接口提供者的业务类别代码，如机动车登记业务：01，驾驶证管理业务：02，事故处理：03，违法处理：04，交警队平台：05，剧毒品业务：062jkxlh接口序列号由外挂系统请求服务平台授权生成下发3jkid接口标识5位，由系统类别＋一位级别代码＋两位接口顺序号组成(参照监管系统)，C：支队、B:总队，A：部局。如01A01代表机动车部局端提供的接口。定义时查询类接口顺序号取50以内的数字，写入接口顺序号定义为50以上的数字。4QueryXmlDoc查询条件封装查询条件的XML格式文档-4-1.2.2.写入类接口PublicStringwriteObjectOut(Stringxtlb,Stringjkxlh,Stringjkid;StringWriteXmlDoc)表2写入类接口调用参数说明序号参数名称参数说明备注信息1xtlb系统类别同上2jkxlh接口序列号同上3jkid接口标识同上4WriteXmlDoc写入数据业务数据写入XML格式文档1.3.XML文件格式定义1.3.1.查询类接口XML文档查询条件QueryXmlDoc的文档格式要求如下：查询返回结果XML文档格式-5-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文档【节点标签】必须和手册中注明的保持一致。-6-1.4.2.返回结果错误代码说明正常返回结果code为成功与否标记（0、失败；1、成功或其他，由提供的接口服务定义），网络异常或接口权限异常等系统原因时返回$E的标记。写入失败时的message返回详细描述信息。-7-第二部分外挂系统接口说明1.接口说明2.接口列表外挂请求服务平台提供的信息接口共47个，见下表,其中写照片接口(红色字体显示)参考第四部分。序号接口名称接口定义提供者接口类型1.机动车信息读取接口【1】读取机动车基本信息【2】读取机动车在办业务信息【3】通过流水号读机动车流水表信息【4】通过号牌号码读机动车流水表信息【5】读取机动车业务日志信息【6】读取机动车证件打印信息【7】读取转出注销机动车信息【8】读取机动车查封信息【9】读取新机动车序列序号【10】获取新机动车业务流水号【11】获取机动车下一检验有效期止机动车信息复用2.写机动车检验信息【1】写机动车检验结果信息【2】写入机动车检验详细信息【3】写入机动车制动力曲线表机动车信息交换3.写机动车选号信息【1】写机动车选号信息（总队版）【2】写机动车选号信息（支队版）机动车信息交换4.写机动车收费信息【1】写机动车收费信息【2】删除机动车收费信息机动车信息交换5.写机动车预录入信息机动车信息交换6.写机动车中间表信息【1】写入机动车保险信息机动车信息交换-8-【2】写入机动车抵押信息【3】写入机动车纳税信息7.写机动车档案编号【1】写机动车临时表档案编号【2】写机动车主表档案编号机动车信息交换8.写机动车照片信息【1】写机动车照片信息【2】写机动车照片中间表信息机动车信息交换9.写机动车业务移交信息【1】写机动车业务日志表信息【2】更新机动车业务表管理部门机动车信息交换10.写机动车所有人联系方式机动车信息交换11.写临时号牌信息机动车信息交换12.写机动车排队信息机动车信息交换13.写机动车报废中间表机动车信息交换14.驾驶证相关信息读取接口【1】读取驾校信息【2】读取教练车信息【3】读取考试场地信息【4】读取考试员信息【5】读取驾驶人照片信息【6】读取考试计划分组信息【7】读取考试计划分组明细信息【8】读取考试预约信息【9】读取驾驶证基本信息【10】读取驾驶证业务流水信息【11】读取驾驶证在办业务流水信息【12】读取准考证明信息【13】读取业务日志信息【14】读取打印历史记录【15】读取驾驶人基本信息驾驶证信息复用15.写预录入信息接口【1】初次申领业务预录入接口【2】体检信息预录入接口驾驶证信息交换16.考试相关信息写入接口【1】预约信息写入接口【2】科目二成绩写入接口驾驶证信息交换-9-【3】科目三成绩写入接口17.驾驶证业务信息写入接口【1】收费信息写入接口【2】业务日志写入接口【3】业务移交信息写入接口【4】业务预警信息写入接口驾驶证信息交换18.驾驶证信息更新接口【1】驾驶人照片写入接口【2】驾驶人联系信息更新接口驾驶证信息交换19.违法业务信息查询接口【1】查询违法基本信息【2】查询制措施凭证（违法处理通知书）【3】查询电子监控文本信息【4】查询电子监控照片信息【5】查询日志信息【6】查询银行对账信息违法信息复用20.银行对账录入接口违法信息交换21.电子监控录入接口【1】电子监控录入接口（已审核）【2】电子监控录入接口（未审核）违法信息交换22.简易处罚决定书写入接口违法信息交换23.强制措施（违法处理通知书）写入接口违法信息交换24.电子监控简易程序处理写入接口违法信息交换25.行政拘留回执信息写入接口违法信息交换26.银行对账罚款收据编号修改接口违法信息交换27.注销最高实习准驾车型业务通知信息写入接口违法信息交换28.读取刑事案件事故信息事故信息复用29.写110接警信息事故信息交换30.写简易事故信息事故信息交换31.写现场图图片信息事故信息交换-10-32.写GIS电子坐标信息事故信息交换33.写刑事案件基本结果信息事故信息交换34.写询问笔录信息事故信息交换35.写谈话记录信息事故信息交换36.查询套牌/假牌机动车信息警务信息信息复用37.查询告知信息【1】查询机动车告知信息【2】查询驾驶人告知信息【3】查询机动车三同和多次告知信息【4】查询机动车非现场违法告知信息警务信息信息复用38.写套牌/假牌机动车信息警务信息信息交换39.查询客货运驾驶人信息信息警务信息信息复用40.写机动车待办业务已告知警务信息信息交换41.写驾驶人待办业务已告知警务信息信息交换42.写机动车三同和多次违法已告知警务信息信息交换43.写机动车非现场违法已告知警务信息信息交换44.写勤务台账信息警务信息信息交换45.写机动车套牌车图片信息警务信息信息交换46.读取通行证信息【1】读取通行证基本信息【2】读取通行证申请审批状态信息剧毒品信息复用47.写通行证核销信息剧毒品信息交换48.写通行证申请预录入信息剧毒品信息交换49.写剧毒品基础信息【1】写承运单位信息【2】写驾驶员信息【3】写押运人员信息【4】写承运车辆信息【5】写购买单位剧毒品信息交换50.用户登录验证综合平台信息交换-11-2.1.机动车接口定义