交通运输部治超信息系统数据接口说明书.docx
《交通运输部治超信息系统数据接口说明书.docx》由会员分享，可在线阅读，更多相关《交通运输部治超信息系统数据接口说明书.docx（41页珍藏版）》请在冰豆网上搜索。
交通运输部治超信息系统数据接口说明书
全国治超信息系统
接口说明书
（试行）
交通运输部规划研究院
2010年3月
文档变更记录
版本号
变更状态
简要说明
变更人
变更日期
1.0
新建
初稿
2010-1/08
1.1
修改
讨论后细化
2010-2-27
1.2
修改
第三稿
2010/3/12
1.3
修改
第四稿
2010/3/16
1.4
修改
第五稿
2010/3/20
1.5
修改
第六稿
2010/3/23
1.6
修改
第七稿
2010/3/24
目录
1前言5
1.1编写目的5
1.2命名规范5
2省中心数据传输接口5
2.1接口访问地址5
2.2高速预检信息上传接口5
2.2.1请求参数5
2.2.2返回信息6
2.3低速精检信息上传接口6
2.3.1请求参数6
2.3.2返回信息6
2.4超限执法信息上传接口7
2.4.1请求参数7
2.4.2返回信息7
2.5超限运输许可证信息上传接口7
2.5.1请求参数7
2.5.2返回信息8
2.6黑名单信息条数查询接口8
2.6.1请求参数8
2.6.2返回信息8
2.7黑名单信息下载接口8
2.7.1请求参数9
2.7.2返回信息9
2.8查询指定时间段内更新的黑名单条数接口9
2.8.1请求参数9
2.8.2返回信息10
2.9下载指定时间段内更新的黑名单信息接口10
2.9.1请求参数10
2.9.2返回信息10
2.10查询车辆违章次数接口11
2.10.1请求参数11
2.10.2返回信息11
2.11下载车辆违章详细信息接口11
2.11.1请求参数12
2.11.2返回信息12
3检测站数据传输接口12
3.1按车牌号查询超限运输许可接口12
3.1.1请求参数12
3.1.2返回信息13
3.2按许可证号查询超限运输许可接口13
3.2.1请求参数13
3.2.2返回信息13
3.3查询车辆是否在黑名单并查询超限次数接口14
3.3.1请求参数14
3.3.2返回信息14
3.4车辆黑名单上超限信息查询接口14
3.4.1请求参数15
3.4.2返回信息15
3.5查询车辆违章次数接口15
3.5.1请求参数15
3.5.2返回信息16
3.6下载车辆违章详细信息接口16
3.6.1请求参数16
3.6.2返回信息16
3.7车辆基本信息查询接口17
3.7.1请求参数17
3.7.2返回信息17
3.8驾驶员信息查询接口17
3.8.1请求参数17
3.8.2返回信息18
4传输对象结构18
4.1高速预检信息Hspinfo18
4.2低速精检信息Lscinfo19
4.3超限执法信息Oeinfo20
4.4超限许可信息Olinfo21
4.5黑名单信息Blinfo21
4.6违章详细信息Oefullinfo22
4.7上传返回信息UploadResult23
4.8下载返回信息DownloadResult24
4.9车辆基本信息Vehicleinfo24
4.10驾驶员信息Driverinfo25
前言
编写目的
此说明书对部中心治超信息系统向省中心治超信息系统和治超检测站信息系统提供的数据访问接口进行说明。
命名规范
所有服务名、方法名和参数名采用匈牙利命名规则；
方法名为动名词结构，表示此方法要实现的功能；方法名首字母大写
参数名以类型或类型的简称开头，后面用一到两个单词或者简写表示其大概的含义；
对象名以大写字母开头，对象的属性全部用小写字母。
省中心数据传输接口
接口访问地址
地址待定。
高速预检信息上传接口
服务名：
ProvService
方法名：
uploadHspinfo
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
6
使用6位国标省数字代码
2
intCount
记录条数
int
2
上传记录的条数，不大于50条
3
hspinfo
预检信息对象
Hspinfo[]
参见第4.1节
4
strTimeStamp
时间戳
string
10
用毫秒数表示的当前时间。
5
strAuth
验证信息
string
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表21
返回信息
返回对象：
UploadResult（参见第4.7节）
低速精检信息上传接口
服务名：
ProvService
方法名：
uploadLscinfo
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
6
使用6位国标省数字代码
2
intCount
记录条数
int
2
上传记录的条数，不大于50条
3
lscInfo
精检信息对象
Lscinfo[]
参见第4.2节
4
strTimeStamp
时间戳
string
10
用毫秒数表示的当前时间
5
strAuth
验证信息
string
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表22
返回信息
返回对象：
UploadResult（参见第4.7节）
超限执法信息上传接口
服务名：
ProvService
方法名：
uploadOeinfo
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
6
使用6位国标省份数字代码
2
intCount
记录条数
int
2
上传记录的条数，不大于50条
3
oeInfo
超限执法信息
Oeinfo[]
参见第4.3节
4
strTimeStamp
时间戳
string
10
以毫秒数表示的当前时间
5
strAuth
验证信息
string
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表23
返回信息
返回对象：
UploadResult（参见第4.7节）
超限运输许可证信息上传接口
服务名：
ProvService
方法名：
uploadOlinfo
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
6
使用6位国标省份代码
2
intCount
记录条数
int
2
上传记录的条数，不大于50条
3
olInfo
超限许可信息对象
Olinfo[]
参见第4.4节
4
strTimeStamp
时间戳
string
10
以毫秒数表示的当前时间
5
strAuth
验证信息
string
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表24
返回信息
返回对象：
UploadResult（参见第4.7节）
黑名单信息条数查询接口
服务名：
ProvService
方法名：
getBlackListCount
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
6
使用6位国标省份代码
2
strTimeStamp
时间戳
string
10
以毫秒表示的当前时间
3
strAuth
验证信息
string
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表25
返回信息
返回对象：
本省的黑名单信息条数。
返回对象数据类型：
int。
返回值说明：
≥0：
查询成功，数值为本省黑名单信息条数
-1：
认证失败
-9：
系统异常
黑名单信息下载接口
服务名：
ProvService
方法名：
downloadBlackList
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
6
使用6位国标省份代码
2
strTimeStamp
时间戳
string
10
用毫秒表示的当前时间
3
pageNo
下载页码
int
2
每次下载50条信息，按照页码确定是哪50条
4
strAuth
验证信息
string
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表26
返回信息
返回对象：
DownloadResult参见第4.8节
查询指定时间段内更新的黑名单条数接口
服务名：
ProvService
方法名：
getBlackListCountByUpdateDate
说明：
时间段采用左闭右开区间，即fromTime≤t＜endTime中的时间t所在区间为指定时间段。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
6
使用6位国标省份代码
2
strTimeStamp
时间戳
string
10
以毫秒计算
3
fromTime
开始时间
datetime
4
endTime
截止时间
datetime
5
strAuth
验证信息
string
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表27
返回信息
返回对象：
指定时间段内更新的黑名单信息条数。
返回对象数据类型：
int。
返回值说明：
≥0：
查询成功，数值为指定时间段内更新的黑名单信息条数
-1：
认证失败
-2：
开始时间晚于截止时间
-9：
系统异常
下载指定时间段内更新的黑名单信息接口
服务名：
ProvService
方法名：
downloadBlackListByUpdateDate
说明：
时间段采用左闭右开区间，即fromTime≤t＜endTime中的时间t所在区间为指定时间段。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
6
使用6位国标省份代码
2
strTimeStamp
时间戳
string
10
以毫秒表示的当前时间
3
fromTime
开始时间
datetime
4
endTime
截止时间
datetime
5
pageNo
下载页码
int
每次下载50条信息，按照页码确定是哪50条
6
strAuth
验证信息
string
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表28
返回信息
返回对象：
DownloadResult（参见第4.8节）
其中retobj为Blinfo[]（参见第4.5节）
查询车辆违章次数接口
服务名：
ProvService
方法名：
getOeCountByVehicleId
说明：
时间段采用左闭右开区间，即fromTime≤t＜endTime中的时间t所在区间为指定时间段。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
31
使用6位国标省份代码
2
strTimestamp
时间戳
string
10
以毫秒计算
3
strVehicleId
车牌号
string
31
4
fromTime
开始时间
datetime
5
endTime
截止时间
datetime
6
strAuth
验证信息
String
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表29
返回信息
返回对象：
指定时间区间内的违章次数。
返回对象数据类型：
int。
返回值说明：
≥0：
查询成功，数值为指定时间区间内的车辆违章次数
-1：
认证失败
-2：
开始时间晚于截止时间
-9：
系统异常
下载车辆违章详细信息接口
服务名：
ProvService
方法名：
downloadOefullinfoByVehicleId
说明：
时间段采用左闭右开区间，即fromTime≤t＜endTime中的时间t所在区间为指定时间段。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strDistrictID
省份代码
string
31
使用6位国标省份代码
2
strTimestamp
时间戳
string
10
以毫秒计算
3
strVehicleId
货车牌号
string
31
4
fromTime
开始日期
datetime
5
endTime
截止日期
datetime
6
strAuth
验证信息
string
255
省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算
表210
返回信息
返回对象：
DownloadResult（参见第4.8节）
其中retobj为Oefullinfo[]（参见第4.6节）
检测站数据传输接口
按车牌号查询超限运输许可接口
服务名：
StationService
方法名：
getOlinfoByVehicleId
说明：
根据车牌号码，查询该车的超限运输许可证详细信息。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strStationID
检测站号
string
31
2
strTimestamp
时间戳
string
10
以毫秒计算
3
strVehicleId
货车牌号
string
31
4
strAuth
验证信息
string
255
检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算
表31
返回信息
返回对象：
DownloadResult参见第4.8节
其中retobj为Olinfo[]（参见第4.4节）
按许可证号查询超限运输许可接口
服务名：
StationService
方法名：
getOlinfoByLicenseNo
说明：
根据超限许可证号，查询该超限运输许可证的详细信息。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strStationID
检测站号
string
31
2
strTimestamp
时间戳
string
10
以毫秒计算
3
strLicenseNo
许可证号
String
31
4
strAuth
验证信息
string
255
检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算
表32
返回信息
返回对象：
DownloadResult参见第4.8节
其中retobj为Olinfo[]（参见第4.4节）
查询车辆是否在黑名单并查询超限次数接口
服务名：
StationService
方法名：
getOverLimitedTimes
说明：
查看指定车牌号码的车辆被列入黑名单中的违章次数，同时可用于查询车辆是否在黑名单中
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strStationID
检测站号
string
31
2
strTimestamp
时间戳
string
10
以毫秒计算
3
strVehicleId
货车牌号
String
31
4
strAuth
验证信息
string
255
检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算
表33
返回信息
返回对象：
该车的违章次数，若返回0，表示该车不在黑名单列表中，大于0则表示该车已经进入黑名单。
返回对象数据类型：
int。
返回值说明：
≥0：
查询成功，
-1：
认证失败
-9：
系统异常
查询车辆黑名单超限信息接口
服务名：
StationService
方法名：
getOverLimitedInfo
说明：
根据货车牌号查询该车辆在黑名单上记录的的超限信息。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strStationID
检测站号
String
31
2
strTimestamp
时间戳
String
10
以毫秒计算
3
strVehicleId
货车牌号
String
31
4
strAuth
验证信息
string
255
检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算
表34
返回信息
返回对象：
DownloadResult参见第4.8节
其中retobj为Oefullinfo[]（参见第4.6节）
查询车辆违章次数接口
服务名：
StationService
方法名：
getOeCountByVehicleId
说明：
时间段采用左闭右开区间，即fromTime≤t＜endTime中的时间t所在区间为指定时间段。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strStationID
省份代码
string
31
2
strTimestamp
时间戳
string
10
以毫秒计算
3
strVehicleId
车牌号
string
31
4
fromTime
开始时间
datetime
5
endTime
截止时间
datetime
6
strAuth
验证信息
string
255
检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算
表35
返回信息
返回对象：
该车在指定时间区间内的违章次数。
返回对象数据类型：
int。
返回值说明：
≥0：
查询成功，数值为指定时间区间内的车辆违章次数
-1：
认证失败
-2：
开始时间晚于截止时间
-9：
系统异常
下载车辆违章详细信息接口
服务名：
ProvService
方法名：
downloadOefullinfoByVehicleId
说明：
时间段采用左闭右开区间，即fromTime≤t＜endTime中的时间t所在区间为指定时间段。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strStationID
省份代码
string
31
2
strTimestamp
时间戳
string
10
以毫秒计算
3
strVehicleId
货车牌号
string
31
4
fromTime
开始时间
datetime
5
endTime
截止时间
datetime
6
strAuth
验证信息
string
255
检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算
表36
返回信息
返回对象：
DownloadResult（参见第4.8节）
其中retobj为Oefullinfo[]（参见第4.6节）
车辆基本信息查询接口
服务名：
StationService
方法名：
getVehicleBaseinfo
说明：
根据车牌号码查询车辆基本信息。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strStationID
检测站号
string
31
2
strTimestamp
时间戳
string
10
以毫秒计算
3
strVehicleId
货车牌号
string
31
4
strAuth
验证信息
string
255
检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算
表37
返回信息
返回对象：
DownloadResult参见第4.8节
其中retobj为VehicleBaseinfo（参见第4.9节）
驾驶员信息查询接口
服务名：
StationService
方法名：
getDriverBaseinfo
说明：
根据驾驶证号查询驾驶员的基本信息。
请求参数
序号
参数名
参数说明
数据类型
长度
备注
1
strStationID
检测站号
String
31
2
strTimestamp
时间戳
String
10
以毫秒计算
3
strDriverId
驾驶证号
String
31
4
strAuth
验证信息
String
255
检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算
表38
返回信息
返回对象：
DownloadResult参见第4.8节
其中retobj为DriverBaseinfo（参见第4.10节）
传输对象结构
高速预检信息Hspinfo
序号
字段名
字段说明
数据类型
长度
备注
1
hspid
预检序号
string
31
2
hsptime
检测时间
datetime
3
stationid
检测站号
string
31
4
vehicleid
货车牌号
string
31
5
vehicletype
货车类型
int
2
6
axlesum
轴数
int
2
7
speed
车速
int
3
8
laneno
车道
int
2
9
totalweight
总重
int
6
单位为千克
10
overlimited
超限量
int
6
单位为千克
11
axle1
轴重1
int
6
单位为千克
12
axle2
轴重2
int
6
单位为千克
13
axle3
轴重3
int
6
单位为千克
14
axle4
轴重4
int
6
单位为千克
15
axle5
轴重5
int
6
单位为千克
16
axle6
轴重6
int
6
单位为千克
17
axle7
轴重7
int
6
单位为千克
18
axle8
轴重8
in
升级会员 