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

2021年1月24日发(作者：梅鼎)



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

接口使用手册










- 1 -
目录


第一部分

接口调用规范

.
.......................... ..............................
- 3 -

1.1.

1.2.

1.2.1.

1.2.2.

1.3.

1.3.1.

1.3.2.

1.4.

1.4.1.

1.4.2.

接口访问地址
.................... .......................................
- 3 -

接口调用函数
............................. ..............................
- 3 -

查询类接口

................................ ...........................
- 3 -

写入类接口

................................ ...........................
- 4 -

XML
文件格式定义

.
................... ...................................
- 4 -

查询类接口
XML
文档
....................... ............................
- 4 -

写入类接口
XML
文档
....................... ............................
- 5 -

调用注意事项
................................... ........................
- 5 -

XML
文档的中文处理

....................... .............................
- 5 -

返回结果错误代码说明
.................................................
- 6 -

第二部分

外挂系统接口说明

.
.............................................. ......
- 7 -

1.

2.

2.1.

接口说明
........................ .......................................
- 7 -

接口列表
............................... ................................
- 7 -

机动车接口定义

.
......................... ...............................
- 11 -



- 2 -
第一部分

接口调用规范


1.1.
接口访问地址

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

http://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
：查询类接口调用参数说明

序号

xtlb
1

参数名称

参数说明

系统类别

备注信息

接口提供者的业务类别代码，

如机动车登记业务：01
，驾驶证管理业务：
02
，事
故处理：
03
，违法 处理：
04
，交警队平台：
05
，剧
毒品业务：
06
由外挂系统请求服务平台授权生成下发

5
位，由系统类别＋一位级别代码＋ 两位接口顺序
号组成
(
参照监管系统
)
，
C
：支队 、
B:
总队，
A
：部
局。
如
01A01
代 表机动车部局端提供的接口。
定义
时查询类接口顺序号取
50
以内的数字，写 入接口
顺序号定义为
50
以上的数字。

封装查询条件的
XML
格式文档



jkxlh
jkid
接口序列号

接口标识

2

3


4


QueryXmlDoc
查询条件


- 3 -
1.2.2.

写
入类接口

Public
String
writeObjectOut
(String
xtlb,String
jkxlh,String jkid;String WriteXmlDoc)
表
2
写入类接口调用参数说明

序号

1

2

3

4

参数名称

参数说明

系统类别

接口序列号

接口标识

写入数据

同上

同上

同上

业务数据写入
XML
格式文档

备注信息


xtlb

jkxlh

jkid

WriteXmlDoc
1.3.
XML
文件格式定义

1.3.1.

查
询类接口
XML
文档

查询条件
QueryXmlDoc
的文档格式要求如下：








查询返回结果
XML
文档格式










- 4 -
1.3.2.

写
入类接口
XML
文档

写入数据
WriteXmlDoc
文档格式如下：







写入操作返回结果文档格式如下：








1.4.
调用注意事项

1.4.1.

X
ML
文档的中文处理

（
1
）接口查询结果进行 过
URLDecoder
和
UTF-8
编码处理
,
须
进行转换（转换函数为
(str,

）才
能正常读取；

（
2
）写入信息中文字符必须
URLEncoder
成
utf-8< br>格式（转
换函数为
(xmlDoc,
；
）后再封装成
XML
文档。

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


- 5 -