交通运输部治超信息系统数据接口说明书.docx

1、交通运输部治超信息系统数据接口说明书全国治超信息系统接口说明书（试行）交通运输部规划研究院2010年3月文档变更记录版本号变更状态简要说明变更人变更日期1.0新建初稿2010-1/081.1修改讨论后细化2010-2-271.2修改第三稿2010/3/121.3修改第四稿2010/3/161.4修改第五稿2010/3/201.5修改第六稿2010/3/231.6修改第七稿2010/3/24目 录1 前言 51.1 编写目的 51.2 命名规范 52 省中心数据传输接口 52.1 接口访问地址 52.2 高速预检信息上传接口 52.2.1 请求参数 52.2.2 返回信息 62.3 低速精检信息

2、上传接口 62.3.1 请求参数 62.3.2 返回信息 62.4 超限执法信息上传接口 72.4.1 请求参数 72.4.2 返回信息 72.5 超限运输许可证信息上传接口 72.5.1 请求参数 72.5.2 返回信息 82.6 黑名单信息条数查询接口 82.6.1 请求参数 82.6.2 返回信息 82.7 黑名单信息下载接口 82.7.1 请求参数 92.7.2 返回信息 92.8 查询指定时间段内更新的黑名单条数接口 92.8.1 请求参数 92.8.2 返回信息 102.9 下载指定时间段内更新的黑名单信息接口 102.9.1 请求参数 102.9.2 返回信息 102.10 查询

3、车辆违章次数接口 112.10.1 请求参数 112.10.2 返回信息 112.11 下载车辆违章详细信息接口 112.11.1 请求参数 122.11.2 返回信息 123 检测站数据传输接口 123.1 按车牌号查询超限运输许可接口 123.1.1 请求参数 123.1.2 返回信息 133.2 按许可证号查询超限运输许可接口 133.2.1 请求参数 133.2.2 返回信息 133.3 查询车辆是否在黑名单并查询超限次数接口 143.3.1 请求参数 143.3.2 返回信息 143.4 车辆黑名单上超限信息查询接口 143.4.1 请求参数 153.4.2 返回信息 153.5 查

4、询车辆违章次数接口 153.5.1 请求参数 153.5.2 返回信息 163.6 下载车辆违章详细信息接口 163.6.1 请求参数 163.6.2 返回信息 163.7 车辆基本信息查询接口 173.7.1 请求参数 173.7.2 返回信息 173.8 驾驶员信息查询接口 173.8.1 请求参数 173.8.2 返回信息 184 传输对象结构 184.1 高速预检信息Hspinfo 184.2 低速精检信息Lscinfo 194.3 超限执法信息Oeinfo 204.4 超限许可信息Olinfo 214.5 黑名单信息Blinfo 214.6 违章详细信息Oefullinfo 224.

5、7 上传返回信息UploadResult 234.8 下载返回信息DownloadResult 244.9 车辆基本信息 Vehicleinfo 244.10 驾驶员信息 Driverinfo 25前言编写目的此说明书对部中心治超信息系统向省中心治超信息系统和治超检测站信息系统提供的数据访问接口进行说明。命名规范所有服务名、方法名和参数名采用匈牙利命名规则；方法名为动名词结构，表示此方法要实现的功能；方法名首字母大写参数名以类型或类型的简称开头，后面用一到两个单词或者简写表示其大概的含义；对象名以大写字母开头，对象的属性全部用小写字母。省中心数据传输接口接口访问地址地址待定。高速预检信息上传接

6、口服务名：ProvService方法名：uploadHspinfo请求参数序号参数名参数说明数据类型长度备注1strDistrictID省份代码string6使用6位国标省数字代码2intCount记录条数int2上传记录的条数，不大于50条3hspinfo预检信息对象Hspinfo参见第4.1节4strTimeStamp时间戳string10用毫秒数表示的当前时间。5strAuth验证信息string255省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算表 21返回信息返回对象：UploadResult（参见第4.7节）低速精检信息上传接口服务名：ProvService方法名：u

7、ploadLscinfo请求参数序号参数名参数说明数据类型长度备注1strDistrictID省份代码string6使用6位国标省数字代码2intCount记录条数int2上传记录的条数，不大于50条3lscInfo精检信息对象Lscinfo参见第4.2节4strTimeStamp时间戳string10用毫秒数表示的当前时间5strAuth验证信息string255省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算表 22返回信息返回对象：UploadResult（参见第4.7节）超限执法信息上传接口服务名：ProvService方法名：uploadOeinfo请求参数序号参数名参数

8、说明数据类型长度备注1strDistrictID省份代码string6使用6位国标省份数字代码2intCount记录条数int2上传记录的条数，不大于50条3oeInfo超限执法信息Oeinfo参见第4.3节4strTimeStamp时间戳string10以毫秒数表示的当前时间5strAuth验证信息string255省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算表 23返回信息返回对象：UploadResult（参见第4.7节）超限运输许可证信息上传接口服务名：ProvService方法名：uploadOlinfo请求参数序号参数名参数说明数据类型长度备注1strDistric

9、tID省份代码string6使用6位国标省份代码2intCount记录条数int2上传记录的条数，不大于50条3olInfo超限许可信息对象Olinfo参见第4.4节4strTimeStamp时间戳string10以毫秒数表示的当前时间5strAuth验证信息string255省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算表 24返回信息返回对象：UploadResult（参见第4.7节）黑名单信息条数查询接口服务名：ProvService方法名： getBlackListCount请求参数序号参数名参数说明数据类型长度备注1strDistrictID省份代码string6使用6

10、位国标省份代码2strTimeStamp时间戳string10以毫秒表示的当前时间3strAuth验证信息string255省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算表 25返回信息返回对象：本省的黑名单信息条数。返回对象数据类型：int。返回值说明：0：查询成功，数值为本省黑名单信息条数-1：认证失败-9：系统异常黑名单信息下载接口服务名：ProvService方法名： downloadBlackList请求参数序号参数名参数说明数据类型长度备注1strDistrictID省份代码string6使用6位国标省份代码2strTimeStamp时间戳string10用毫秒表示的

11、当前时间3pageNo下载页码int2每次下载50条信息，按照页码确定是哪50条4strAuth验证信息string255省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算表 26返回信息返回对象：DownloadResult 参见第4.8节 查询指定时间段内更新的黑名单条数接口服务名：ProvService方法名： getBlackListCountByUpdateDate说明：时间段采用左闭右开区间，即fromTimetendTime中的时间t所在区间为指定时间段。请求参数序号参数名参数说明数据类型长度备注1strDistrictID省份代码string6使用6位国标省份代码2s

12、trTimeStamp时间戳string10以毫秒计算3fromTime开始时间datetime4endTime截止时间datetime5strAuth验证信息string255省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算表 27返回信息返回对象：指定时间段内更新的黑名单信息条数。返回对象数据类型：int。返回值说明：0：查询成功，数值为指定时间段内更新的黑名单信息条数-1：认证失败-2：开始时间晚于截止时间-9：系统异常下载指定时间段内更新的黑名单信息接口服务名：ProvService方法名：downloadBlackListByUpdateDate说明：时间段采用左闭右开区

13、间，即fromTimetendTime中的时间t所在区间为指定时间段。请求参数序号参数名参数说明数据类型长度备注1strDistrictID省份代码string6使用6位国标省份代码2strTimeStamp时间戳string10以毫秒表示的当前时间3fromTime开始时间datetime4endTime截止时间datetime5pageNo下载页码int每次下载50条信息，按照页码确定是哪50条6strAuth验证信息string255省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算表 28返回信息返回对象：DownloadResult (参见第4.8节)其中retobj为Bl

14、info（参见第4.5节）查询车辆违章次数接口服务名：ProvService方法名：getOeCountByVehicleId说明：时间段采用左闭右开区间，即fromTimetendTime中的时间t所在区间为指定时间段。请求参数序号参数名参数说明数据类型长度备注1strDistrictID省份代码string31使用6位国标省份代码2strTimestamp时间戳string10以毫秒计算3strVehicleId车牌号string314fromTime开始时间datetime5endTime截止时间datetime6strAuth验证信息String255省份代码+时间戳+密钥（统一由部里

15、发放），然后进行MD5计算表 29返回信息返回对象：指定时间区间内的违章次数。返回对象数据类型：int。返回值说明：0：查询成功，数值为指定时间区间内的车辆违章次数-1：认证失败-2：开始时间晚于截止时间-9：系统异常下载车辆违章详细信息接口服务名：ProvService方法名：downloadOefullinfoByVehicleId说明：时间段采用左闭右开区间，即fromTimetendTime中的时间t所在区间为指定时间段。请求参数序号参数名参数说明数据类型长度备注1strDistrictID省份代码string31使用6位国标省份代码2strTimestamp时间戳string10以毫

16、秒计算3strVehicleId货车牌号string314fromTime开始日期datetime5endTime截止日期datetime6strAuth验证信息string255省份代码+时间戳+密钥（统一由部里发放），然后进行MD5计算表 210返回信息返回对象：DownloadResult （参见第4.8节）其中 retobj 为 Oefullinfo （参见第4.6节）检测站数据传输接口按车牌号查询超限运输许可接口服务名：StationService方法名：getOlinfoByVehicleId说明：根据车牌号码，查询该车的超限运输许可证详细信息。请求参数序号参数名参数说明数据类型长

17、度备注1strStationID检测站号string312strTimestamp时间戳string10以毫秒计算3strVehicleId货车牌号string314strAuth验证信息string255检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算表 31返回信息返回对象：DownloadResult 参见第4.8节其中retobj为 Olinfo （参见第4.4节）按许可证号查询超限运输许可接口服务名：StationService方法名：getOlinfoByLicenseNo说明：根据超限许可证号，查询该超限运输许可证的详细信息。请求参数序号参数名参数说明数据类型长度备注

18、1strStationID检测站号string312strTimestamp时间戳string10以毫秒计算3strLicenseNo许可证号String314strAuth验证信息string255检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算表 32返回信息返回对象：DownloadResult 参见第4.8节其中retobj为 Olinfo （参见第4.4节）查询车辆是否在黑名单并查询超限次数接口服务名：StationService方法名：getOverLimitedTimes说明：查看指定车牌号码的车辆被列入黑名单中的违章次数，同时可用于查询车辆是否在黑名单中请求参数序号

19、参数名参数说明数据类型长度备注1strStationID检测站号string312strTimestamp时间戳string10以毫秒计算3strVehicleId货车牌号String314strAuth验证信息string255检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算表 33返回信息返回对象：该车的违章次数，若返回0，表示该车不在黑名单列表中，大于0则表示该车已经进入黑名单。返回对象数据类型：int。返回值说明：0：查询成功， -1：认证失败-9：系统异常查询车辆黑名单超限信息接口服务名：StationService方法名：getOverLimitedInfo说明：根据货

20、车牌号查询该车辆在黑名单上记录的的超限信息。请求参数序号参数名参数说明数据类型长度备注1strStationID检测站号String312strTimestamp时间戳String10以毫秒计算3strVehicleId货车牌号String314strAuth验证信息string255检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算表 34返回信息返回对象： DownloadResult 参见第4.8节其中retobj 为 Oefullinfo （参见第4.6节）查询车辆违章次数接口服务名：StationService方法名：getOeCountByVehicleId说明：时间段采

21、用左闭右开区间，即fromTimetendTime中的时间t所在区间为指定时间段。请求参数序号参数名参数说明数据类型长度备注1strStationID省份代码string312strTimestamp时间戳string10以毫秒计算3strVehicleId车牌号string314fromTime开始时间datetime5endTime截止时间datetime6strAuth验证信息string255检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算表 35返回信息返回对象：该车在指定时间区间内的违章次数。返回对象数据类型：int。返回值说明：0：查询成功，数值为指定时间区间内的车辆

22、违章次数-1：认证失败-2：开始时间晚于截止时间-9：系统异常下载车辆违章详细信息接口服务名：ProvService方法名：downloadOefullinfoByVehicleId说明：时间段采用左闭右开区间，即fromTimetendTime中的时间t所在区间为指定时间段。请求参数序号参数名参数说明数据类型长度备注1strStationID省份代码string312strTimestamp时间戳string10以毫秒计算3strVehicleId货车牌号string314fromTime开始时间datetime5endTime截止时间datetime6strAuth验证信息string25

23、5检测站号+时间戳+密钥（统一由部里发放），然后进行MD5计算表 36返回信息返回对象：DownloadResult （参见第4.8节）其中 retobj 为 Oefullinfo （参见第4.6节）车辆基本信息查询接口服务名：StationService方法名：getVehicleBaseinfo说明：根据车牌号码查询车辆基本信息。 请求参数序号参数名参数说明数据类型长度备注1strStationID检测站号string312strTimestamp时间戳string10以毫秒计算3strVehicleId货车牌号string314strAuth验证信息string255检测站号+时间戳+密

24、钥（统一由部里发放），然后进行MD5计算表 37返回信息返回对象：DownloadResult 参见第4.8节其中retobj 为VehicleBaseinfo （参见第4.9节）驾驶员信息查询接口服务名：StationService方法名：getDriverBaseinfo说明：根据驾驶证号查询驾驶员的基本信息。 请求参数序号参数名参数说明数据类型长度备注1strStationID检测站号String312strTimestamp时间戳String10以毫秒计算3strDriverId驾驶证号String314strAuth验证信息String255检测站号+时间戳+密钥（统一由部里发放），

25、然后进行MD5计算表 38返回信息返回对象：DownloadResult 参见第4.8节其中retobj 为DriverBaseinfo （参见第4.10节）传输对象结构高速预检信息Hspinfo序号字段名字段说明数据类型长度备注1hspid预检序号string312hsptime检测时间datetime3stationid检测站号string314vehicleid货车牌号string315vehicletype货车类型int26axlesum轴数int27speed车速int38laneno车道int29totalweight总重int6单位为千克10overlimited超限量int6单位为千克11axle1轴重1int6单位为千克12axle2轴重2int6单位为千克13axle3轴重3int6单位为千克14axle4轴重4int6单位为千克15axle5轴重5int6单位为千克16axle6轴重6int6单位为千克17axle7轴重7int6单位为千克18axle8轴重8in