机动车检测线内接口使用基础手册.doc

机动车检查监管系统

仪器设备检查项目接口使用手册

2月

目 录
1.接口访问地址 1
2.接口调用阐明 1
3.自定义接口 1
18C10 获取可以上线检查车辆列表 2
18C11 依照检查流水号获取车辆详细信息 3
18C12 捕获工位照片并上传 8
4.仪器设备检查项目惯用接口 9
18C55机动车检查项目开始信息 10
18C50 时间同步接口 10
18C80 机动车人工检查项目检查成果详细信息 11
18C81 仪器设备检查项目检查成果详细信息 12
18C58 机动车检查项目结束信息 13
18C82 机动车检查成果其她信息 14
5.征询电话 15

1.接口访问地址
检查监管系统对外接口访问地址：
http://ip:port/TmriOutAccess.asmx
其中IP标记检查机构站点服务器地址；port相应系统服务端标语。
2.接口调用阐明
各检查机构可通过自定义接口获取可以进行仪器设备检查项目车辆信息，当获取该信息后，检查机构控制系统软件负责按照公安部规定流程，完毕整个仪器检查项目检查工作及数据传播，其接口调用办法及接口名称与公安部文档完全一致。
3.自定义接口
为了使各检查机构不同软件厂家可以顺利与统一管理平台进行对接，本系统对公安部接口进行了某些扩充。扩充接口分别为：
18C10—获取可以上线检查车辆列表；
18C11—依照检查流水号获取车辆详细信息；
18C12—捕获工位照片并上传。
其她办法为公安网接口。详情见公安部《机动车检查监管系统接口使用手册》。

18C10 获取可以上线检查车辆列表
接口类型：查询类接口
接口标示：18C10
功能阐明：依照调用者身份Key获得当前检测站所有可进行线内检查车辆列表及概要信息，其中概要信息涉及：检查流水号，号牌号码，号牌种类，号牌颜色，车辆所属人，车辆辨认代号等信息。
解决过程：
对接口输入参数进行逻辑校验。
查询相应安检机构可进行线内检查车辆列表及概要信息
查询文档QueryXmlDoc阐明：节点标签QueryCondition，查询条件数据字段如下列表：

序号
参数项
名称
类型
长度
与否可空
备注
1
jcxdh
检测线
Varchar2
2
不可空

2
jyjgbh
检查机构编号
Varchar2
10
不可空

调用事例：
入参：
<?xml version='1.0' encoding='GBK'?>
<root>
<QueryCondition>
<jcxdh>1</jcxdh>
<jyjgbh></jyjgbh>
</QueryCondition>
</root>
成果文档XmlDoc阐明：节点标签vehispara，返回数据字段如下
序号
参数项
名称
类型
长度
与否可空
备注
1
jylsh
检查流水号
Varchar2
17
不可空
对同一安检机构，此检查流水号必要
唯一，下同
2
hphm
号牌号码
Varchar2
15
不可空
在用车不可空。填写格式如：“苏
BAA345”填写“苏BAA345”、“苏
B1234 挂”填写“苏B1234”，下同。
3
hpzl
号牌种类
Varchar2
2
不可空
按GA/T16.7。在用车不可空。
4
hpys
号牌颜色
Varchar2
5
不可空
例如：黑，黄，蓝，白
5
syr
车辆所属人
Varchar2
128
不可空

6
clsbdh
车辆辨认代号
Varchar2
25
不可空

18C11 依照检查流水号获取车辆详细信息
接口类型：查询类接口
接口标示：18C11
功能阐明：依照检查流水号获取线内需检查车辆详细信息。其中详细信息重要涉及：检查流水号，号牌号码，号牌种类，车辆辨认代号，发动机/电动机号码等68项信息。
解决过程：
（1）对接口输入参数进行逻辑校验。
（2）查询相应流水号相应需检查车辆详细信息。
查询文档QueryXmlDoc阐明：节点标签QueryCondition，查询条件数据字段如下

序号
参数项
名称
类型
长度
与否可空
备注
1
jylsh
检查流水号
Varchar2
17
不可空

调用事例：
入参：
<?xml version='1.0' encoding='GBK'?>
<root>
<QueryCondition>
<jylsh>1</jylsh>
</QueryCondition>
</root>
成果文档XmlDoc阐明：节点标签vehispara，返回数据字段如下
序号
参数项
名称
类型
长度
与否可空
备注
1
jylsh
检查流水号
Varchar2
17
不可空
对同一安检机构，此检查流水号必要
唯一，下同
2
jyjgbh
检查机构编号
Varchar2
10
不可空
按安检机构备案信息，下同
3
jcxdh
检测线代号
Varchar2
2
可空
按检测线备案信息，下同，如：1、2、
3、4、5、6、7、8、9、10,…
4
xh
机动车序号
Varchar2
14
可空

5
hpzl
号牌种类
Varchar2
2
可空
按GA/T16.7。在用车不可空。
6
hphm
号牌号码
Varchar2
15
可空
在用车不可空。填写格式如：“苏
BAA345”填写“苏BAA345”、“苏
B1234 挂”填写“苏B1234”，下同。
7
clsbdh
车辆辨认代号
Varchar2
25
不可空
填写完整VIN 号或车架号。
8
fdjh
发动机/电动机号码
Varchar2
30
可空

9
csys
车身颜色
Varchar2
5
可空
按GA/T16.8
10
syxz
使用性质
Char
1
可空
按GA/T16.3
11
ccdjrq
初次登记日期
date

可空
按“yyyy-mm-dd”格式填写
12
jyrq
近来定检日期
date

可空
按“yyyy-mm-dd”格式填写
13
jyyxqz
检查有效期止
date

可空
按“yyyy-mm-dd”格式填写
14
bxzzrq
保险终结日期
date

可空
按“yyyy-mm-dd”格式填写
15
rlzl
燃料种类
Varchar2
3
可空
可同步输入三种，每种按GA/T16.9
16
gl
功率
Number
5,1
可空
单位为千瓦（kw），四位整数，一位
小数
17
zs
轴数
Number
1
不可空

18
zj
轴距
Number
5
可空
单位为毫米（mm）
19
qlj
前轮距
Number
4
可空
单位为毫米（mm）
20
hlj
后轮距
Number
4
可空
单位为毫米（mm）
21
zzl
总质量
Number
8
不可空
单位为公斤（kg）
22
zbzl
整备质量
Number
8
不可空
单位为公斤（kg）
23
ccrq
出厂日期
date

不可空
按“yyyy-mm-dd”格式填写
24
qdxs
驱动形式（驱动轴位）
Varchar2
5
不可空
组合串:如1234(1 表达一轴..)
25
zczs
驻车轴数
Number
1
可空
摩托车无此参数
26
zczw
驻车轴位
Varchar2
5
可空
组合串:如1234(1 表达一轴..)
27
zzs
主轴数
number
1
可空

28
zzly
制动力源
char
1
可空
0-气压制动，1-液压制动，2-气推油
制动
29
qzdz
前照灯制
Varchar2
2
可空
01-四灯远近光，02-四灯远光，03-
二灯远近光，04-二灯近光，05-一灯
远光
30
ygddtz
远光单独调节
char
1
可空
0-不能单独调节，1-单独调节
31
zxzxjxs
转向轴（前轴）悬架形
式
char
1
可空
0-独立悬架，1-非独立悬架
32
lcbds
里程表读数
number
8
可空
单位为千米（km）
33
jyxm
检查项目
Varchar2
100
不可空
多值，英文半角逗号分隔。各项目代
码为：
F1-车辆外观检查
C1-底盘检查
DC-动态底盘检查
B1-一轴制动
B2-二轴制动
B3-三轴制动
B4-四轴制动
B0-驻车制动
H1-左外灯或二三轮机动车左灯
H2-左内灯
H3-右内灯
H4-右外灯或二三轮机动车右灯
X1-双怠速排放
X3-烟度
X4-工况法
X5-不透光
S1-车速表
A1-侧滑或二三轮汽车轮偏
P1-功率检查
R1-路试制动
R2-路试坡道驻车
R3-路试车速表
34
jylb
检查类别
Varchar2
2
不可空
00-注册登记检查，01-在用车检查
（定检），02-暂时检查，03-特殊检
验，04-在用车检查（非定检）
35
bhgx
不合格项
Varchar2
50
可空

36
ccdlsj
初次登录时间
date

可空
按“yyyy-mm-dd hh24:mi:ss”格式
填写
37
dlsj
登录时间
date

不可空
按“yyyy-mm-dd hh24:mi:ss”格式
填写
38
jycs
检查次数
number
2
不可空

39
dly
登录员
Varchar2
30
不可空

40
ycy
引车员
Varchar2
30
可空

41
wjy
外检员
Varchar2
30
可空

42
dtjyy
动态检查员
Varchar2
30
可空

43
dpjyy
底盘检查员
Varchar2
30
可空

44
clpp1
车辆品牌
Varchar2
32
不可空

45
clxh
车辆型号
Varchar2
32
不可空

46
syr
机动车所有人
Varchar2
128
可空

47
cllx
车辆类型
Varchar2
3
可空
在用车不可空
48
cwkc
车外廓长
number
5
不可空

49
cwkk
车外廓宽
number
4
不可空

50
cwkg
车外廓高
number
4
不可空

51
clyt
车辆用途
char
2

52
ytsx
用途属性
char
1

53
dlysfzh
登录员（身份证号）
Varchar2
30
不可空

54
ycysfzh
引车员（身份证号）
Varchar2
30
可空

55
wjysfzh
外检员（身份证号）
Varchar2
30
可空

56
dtjyysfzh
动态检查员（身份证号）
Varchar2
30
可空

57
dpjyysfzh
底盘检查员（身份证号
Varchar2
30
可空

58
clsslb
车辆所属类别
Varchar2
2
不可空
01-常规
02-全时四驱
03-超重
04-超宽
05-驱动防滑
06-双后轴驱动
07-挂车
08-灯位超高
09-多轴车
59
jcxlb
检测线类别
Char
1
不可空
1‐汽车，2‐摩托车
60
sjr
送检人（姓名）
Varchar2
30
可空

61
sjrsfzh
送检人身份证号
Varchar2
30
可空

62
xjxs
悬架形式
Varchar2
30
可空

63
qcz
驱车轴
Varchar2
30
可空

64
qzdz
前置灯制
Varchar2
30
可空

65
zdcs
最大设计车速
number
5
可空

66
dgdt
灯光单调
Varchar2
30
可空

67
zdxs
制动形式
Varchar2
30
可空

68
zws
座位数
number
3
可空

69
hpys
号牌颜色
Char
2
可空

18C12 捕获工位照片并上传
接口类型：写入类接口
接口标示：18C12
功能阐明：依照传入检查项目捕获相应照片。当传入检查项目为C1（底盘检查）时，捕获底盘工位拍摄照片。当传入检查项目为B（制动检查）时，捕获制动工位拍摄照片。当传入检查项目为H（灯光检查）时，捕获灯光工位拍摄照片。
解决过程：
对接口输入参数进行逻辑校验。
捕获所需检查项目工位照片
写入文档WriteXmlDoc阐明：节点标签vehispara，写入数据字段如下列表：
序号
参数项
名称
类型
长度
与否可空
备注
1
jylsh
检查流水号
Varchar2
17
不可空
对同一安检机构，此检查流水号必要唯一，下同
2
jcxdh
检测线代号
Varchar2
2
不可空

3
jyxm
检查项目
Varchar2
2
不可空
C1-底盘检查
B1-制动
B2-平板
H-灯光
4
hphm
号牌号码
Varchar2
15
不可空

5
hpzl
号牌种类
Varchar2
2
可空

返回成果文档ResultXml阐明：返回成果XML 文档，code（标记，1 成功；不大于0 失败，$E 为系统异常）、message（描述信息）、keystr（加密串）。
code 标记定义如下：

Code值
阐明
1
数据写入成功
2
车辆正在检测中
-01004
查无此车 _18C12
-01005
捕获照片失败 _18C12
-01010
上传照片失败
-01001
接口超限
01002
请校验接口对的性
-01000
调用公安网失败

入参：
<?xml version='1.0' encoding='GBK'?>
<root>
<vehispara>
<jylsh>1</jylsh>
<jyjgbh></jyjgbh>
<jcxdh>1</jcxdh>
<jyxm>B1</jyxm>
<hphm>%e9%bb%91L00367</hphm>
<hpzl>02</hpzl>
</vehispara>
</root>

4.仪器设备检查项目惯用接口
如下为《机动车检查监管系统接口使用手册》中规定仪器设备检查项目时所需要经常使用接口，接口文档详见《机动车检查监管系统接口使用手册》。xml仅供参照。
18C55机动车检查项目开始信息
入参
<?xml version='1.0' encoding='GBK'?>
<root>
<vehispara>
<jylsh>1</jylsh>
<jyjgbh></jyjgbh>
<jcxdh>1</jcxdh>
<jycs>1</jycs>
<hpzl>02</hpzl>
<hphm>%e9%bb%91L00367</hphm>
<clsbdh>0047874</clsbdh>
<gwjysbbh>01</gwjysbbh>
<jyxm>B2</jyxm>
<kssj>-01-03 13:58:30</kssj>
</vehispara>
</root>
18C55：出参
<?xml version="1.0" encoding="GBK"?>
<root>
<head>
<dtdpjyxm></dtdpjyxm>
<dpjyxm></dpjyxm>
<keystr></keystr>
<wgjyzp></wgjyzp>
<pdyj></pdyj>
<message>成功</message>
<zlzp></zlzp>
<cyxm></cyxm>
<cyzp></cyzp>
<code>1</code>
<wgjcxm></wgjcxm>
</head>
</root>

18C50 时间同步接口
入参：
<?xml version='1.0' encoding='GBK'?>
<root>
<QueryCondition>
<babh></babh>
</QueryCondition>
</root>
出参：
<?xml version="1.0" encoding="GBK"?>
<root>
<head>
<code>1</code>
<message>数据下载成功！</message>
<rownum>1</rownum>
</head>
<body>
<vehispara id="0">
<sj>-01-03 13:57:13.833</sj>
</vehispara>
</body></root>

18C80 机动车人工检查项目检查成果详细信息
入参：
<?xml version='1.0' encoding='GBK'?>
<root>
<vehispara>
<jylsh>1</jylsh>
<jyjgbh></jyjgbh>
<jcxdh>1</jcxdh>
<jycs>1</jycs>
<jyxm>C1</jyxm>
<hpzl>02</hpzl>
<hphm>%e9%bb%91L00367</hphm>
<clsbdh>0047874</clsbdh>
<rzxxbj>1</rzxxbj>
<rcdxbj>1</rcdxbj>
<rxsxbj>1</rxsxbj>
<rzdxbj>1</rzdxbj>
<rqtbj>1</rqtbj>
<jyyjy></jyyjy>
<dpjcjyy>%e9%a9%ac%e5%88%a9%e5%86%9b</dpjcjyy>
<dpjyysfzh>2301027</dpjyysfzh>
</vehispara>
</root>
出参：
<?xml version="1.0" encoding="GBK"?>
<root>
<head>
<dtdpjyxm></dtdpjyxm>
<dpjyxm></dpjyxm>
<keystr></keystr>
<wgjyzp></wgjyzp>
<pdyj></pdyj>
<message>成功</message>
<zlzp></zlzp>
<cyxm></cyxm>
<cyzp></cyzp>
<code>1</code>
<wgjcxm></wgjcxm>
</head>
</root>
18C81 仪器设备检查项目检查成果详细信息
以车速表为例：
入参：
<?xml version='1.0' encoding='GBK'?>
<root>
<vehispara>
<jylsh>1</jylsh>
<jyjgbh></jyjgbh>
<jcxdh>1</jcxdh>
<jyxm>S1</jyxm>
<jycs>1</jycs>
<csdscz></csdscz>
<csbpd>1</csbpd>
</vehispara>
</root>
出参：
<?xml version="1.0" encoding="GBK"?>
<root>
<head>
<dtdpjyxm></dtdpjyxm>
<dpjyxm></dpjyxm>
<keystr></keystr>
<wgjyzp></wgjyzp>
<pdyj></pdyj>
<message>成功</message>
<zlzp></zlzp>
<cyxm></cyxm>
<cyzp></cyzp>
<code>1</code>
<wgjcxm></wgjcxm>
</head>
</root>
18C58 机动车检查项目结束信息
入参：
<?xml version='1.0' encoding='GBK'?>
<root>
<vehispara>
<jylsh>1</jylsh>
<jyjgbh></jyjgbh>
<jcxdh>1</jcxdh>
<jycs>1</jycs>
<jyxm>S1</jyxm>
<hpzl>02</hpzl>
<hphm>%e9%bb%91L00367</hphm>
<clsbdh>0047874</clsbdh>
<gwjysbbh>05</gwjysbbh>
<jssj>-01-03 13:57:29</jssj>
</vehispara>
</root>
18C58出参：
<?xml version="1.0" encoding="GBK"?>
<root>
<head>
<dtdpjyxm></dtdpjyxm>
<dpjyxm></dpjyxm>
<keystr></keystr>
<wgjyzp></wgjyzp>
<pdyj></pdyj>
<message>成功</message>
<zlzp></zlzp>
<cyxm></cyxm>
<cyzp></cyzp>
<code>1</code>
<wgjcxm></wgjcxm>
</head>
</root>
18C82 机动车检查成果其她信息
入参
<?xml version='1.0' encoding='GBK'?>
<root>
<vehispara>
<jylsh>1</jylsh>
<jyjgbh></jyjgbh>
<jcxdh>1</jcxdh>
<hphm>%e9%bb%91L00367</hphm>
<hpzl>02</hpzl>
<clsbdh>0047874</clsbdh>
<ycyxm></ycyxm>
<ycysfzh></ycysfzh>
<zczdl>41.9</zczdl>
<zczdpd>2</zczdpd>
<zczdjyjg>0</zczdjyjg>
<zdjccs>1</zdjccs>
<zcpd>2</zcpd>
<zjccs>1</zjccs>
<jczczbzl></jczczbzl>
<bzzczbzl></bzzczbzl>
<zczbzlbfb></zczbzlbfb>
<zbzlpd></zbzlpd>
</vehispara>
</root>
出参：
<?xml version="1.0" encoding="GBK"?>
<root>
<head>
<dtdpjyxm></dtdpjyxm>
<dpjyxm></dpjyxm>
<keystr></keystr>
<wgjyzp></wgjyzp>
<pdyj></pdyj>
<message>成功</message>
<zlzp></zlzp>
<cyxm></cyxm>
<cyzp></cyzp>
<code>1</code>
<wgjcxm></wgjcxm>
</head>
</root>
5.征询电话
各检查机构与管理平台进行对接时，如遇技术问题，可以致电征询。征询电话：。