外挂系统接口使用手册201408

交通管理警务综合应用平台外挂系统请求服务

接口使用手册

公安部交通管理科学研究所

2014年8月

第一部分接口调用规范

1.1 接口访问地址

外挂系统请求服务的接口访问地址：

ip:port/ trffweb/services/TmriOutAccess?wsdl

其中IP标识Web服务器地址；port对应系统应用服务的端口号，启用80的不填写。

1.2 接口调用函数

外挂系统请求服务平台的接口包括两类：查询类和写入类接口。查询类接口对外提供查询服务，写入类接口对外提供将业务数据写入综合应用平台业务库。

1.2.1 查询类接口

public StringqueryObjectOut(Stringxtlb,String jkxlh,String jkid,String QueryXmlDoc);

表1：查询类接口调用参数说明

序号	参数名称	参数说明	备注信息
1	xtlb	系统类别	接口提供者的业务类别代码，如机动车登记业务：01，驾驶证管理业务：02，违法处理：03，事故处理：04，交警队平台：10，剧业务：06
2	jkxlh	接口序列号	由外挂系统请求服务平台授权生成下发
3	jkid	接口标识	5位，由系统类别＋一位级别代码＋两位接口顺序号组成(参照监管系统)，C：支队、B:总队，A：部局。如01A01代表机动车部局端提供的接口。定义时查询类接口顺序号取50以内的数字，写入接口顺序号定义为50以上的数字。
4	QueryXmlDoc	查询条件	封装查询条件的XML格式文档

1.2.2 写入类接口

Public String writeObjectOut (String xtlb,String jkxlh,String jkid;String WriteXmlDoc)

表2 写入类接口调用参数说明

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格式（转换函数为de(xmlDoc, "utf-8")；）后再封装成XML文档。

（3）XML文档的【写入数据字段】和【返回结果字段】的标签均为小写字符。XML文档【节点标签】必须和手册中注明的保持一致。

1.4.2返回结果错误代码说明

正常返回结果code为成功与否标记（0、失败；1、成功或其他，由提供的接口服务定义），网络异常或接口权限异常等系统原因时返回$E的标记。写入失败时的message返回详细描述信息。

第二部分外挂系统接口说明

外挂请求服务平台提供的信息接口共61个，见下表,其中写照片接口(红字体显示)参考第四部分。