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高速預檢信息上傳接口5請求參數5返回信息62.3低速精檢信息上傳接口6請求參數6返回信息62.4超限執法信息上傳接口7請求參數7返回信息72.5超限運

2、輸許可證信息上傳接口7請求參數7返回信息82.6黑名單信息條數查詢接口8請求參數8返回信息82.7黑名單信息下載接口8請求參數9返回信息92.8查詢指定時間段內更新的黑名單條數接口9請求參數9返回信息102.9下載指定時間段內更新的黑名單信息接口10請求參數10返回信息102.10查詢車輛違章次數接口11請求參數11返回信息112.11下載車輛違章詳細信息接口11請求參數12返回信息123檢測站數據傳輸接口123.1按車牌號查詢超限運輸許可接口12請求參數12返回信息133.2按許可證號查詢超限運輸許可接口13請求參數13返回信息133.3查詢車輛是否在黑名單并查詢超限次數接口14請求參數14

3、返回信息143.4車輛黑名單上超限信息查詢接口14請求參數15返回信息153.5查詢車輛違章次數接口15請求參數15返回信息163.6下載車輛違章詳細信息接口16請求參數16返回信息163.7車輛基本信息查詢接口17請求參數17返回信息173.8駕駛員信息查詢接口17請求參數17返回信息184傳輸對象結構184.1高速預檢信息Hspinfo184.2低速精檢信息Lscinfo194.3超限執法信息Oeinfo204.4超限許可信息Olinfo214.5黑名單信息Blinfo214.6違章詳細信息Oefullinfo224.7上傳返回信息UploadResult234.8下載返回信息Downlo

4、adResult244.9車輛基本信息 Vehicleinfo244.10駕駛員信息 Driverinfo251 前言1.1 編寫目的此說明書對部中心治超信息系統向省中心治超信息系統和治超檢測站信息系統提供的數據訪問接口進行說明。1.2 命名規范所有服務名、方法名和參數名采用匈牙利命名規則；方法名為動名詞結構，表示此方法要實現的功能；方法名首字母大寫參數名以類型或類型的簡稱開頭，后面用一到兩個單詞或者簡寫表示其大概的含義；對象名以大寫字母開頭，對象的屬性全部用小寫字母。2 省中心數據傳輸接口2.1 接口訪問地址地址待定。2.2 高速預檢信息上傳接口服務名：ProvService方法名：uplo

5、adHspinfo2.2.1 請求參數序號參數名參數說明數據類型長度備注1strDistrictID省份代碼string6使用6位國標省數字代碼2intCount記錄條數int2上傳記錄的條數，不大于50條3hspinfo預檢信息對象Hspinfo參見第4.1節4strTimeStamp時間戳string10用毫秒數表示的當前時間。5strAuth驗證信息string255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 212.2.2 返回信息返回對象：UploadResult（參見第4.7節）2.3 低速精檢信息上傳接口服務名：ProvService方法名：uploadLsc

6、info2.3.1 請求參數序號參數名參數說明數據類型長度備注1strDistrictID省份代碼string6使用6位國標省數字代碼2intCount記錄條數int2上傳記錄的條數，不大于50條3lscInfo精檢信息對象Lscinfo參見第4.2節4strTimeStamp時間戳string10用毫秒數表示的當前時間5strAuth驗證信息string255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 222.3.2 返回信息返回對象：UploadResult（參見第4.7節）2.4 超限執法信息上傳接口服務名：ProvService方法名：uploadOeinfo2.4

7、.1 請求參數序號參數名參數說明數據類型長度備注1strDistrictID省份代碼string6使用6位國標省份數字代碼2intCount記錄條數int2上傳記錄的條數，不大于50條3oeInfo超限執法信息Oeinfo參見第4.3節4strTimeStamp時間戳string10以毫秒數表示的當前時間5strAuth驗證信息string255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 232.4.2 返回信息返回對象：UploadResult（參見第4.7節）2.5 超限運輸許可證信息上傳接口服務名：ProvService方法名：uploadOlinfo2.5.1 請求

8、參數序號參數名參數說明數據類型長度備注1strDistrictID省份代碼string6使用6位國標省份代碼2intCount記錄條數int2上傳記錄的條數，不大于50條3olInfo超限許可信息對象Olinfo參見第4.4節4strTimeStamp時間戳string10以毫秒數表示的當前時間5strAuth驗證信息string255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 242.5.2 返回信息返回對象：UploadResult（參見第4.7節）2.6 黑名單信息條數查詢接口服務名：ProvService方法名： getBlackListCount2.6.1 請求參

9、數序號參數名參數說明數據類型長度備注1strDistrictID省份代碼string6使用6位國標省份代碼2strTimeStamp時間戳string10以毫秒表示的當前時間3strAuth驗證信息string255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 252.6.2 返回信息返回對象：本省的黑名單信息條數。返回對象數據類型：int。返回值說明：0：查詢成功，數值為本省黑名單信息條數-1：認證失敗-9：系統異常2.7 黑名單信息下載接口服務名：ProvService方法名： downloadBlackList2.7.1 請求參數序號參數名參數說明數據類型長度備注1st

10、rDistrictID省份代碼string6使用6位國標省份代碼2strTimeStamp時間戳string10用毫秒表示的當前時間3pageNo下載頁碼int2每次下載50條信息，按照頁碼確定是哪50條4strAuth驗證信息string255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 262.7.2 返回信息返回對象：DownloadResult 參見第4.8節 2.8 查詢指定時間段內更新的黑名單條數接口服務名：ProvService方法名： getBlackListCountByUpdateDate說明：時間段采用左閉右開區間，即fromTimetendTime中的

11、時間t所在區間為指定時間段。2.8.1 請求參數序號參數名參數說明數據類型長度備注1strDistrictID省份代碼string6使用6位國標省份代碼2strTimeStamp時間戳string10以毫秒計算3fromTime開始時間datetime4endTime截止時間datetime5strAuth驗證信息string255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 272.8.2 返回信息返回對象：指定時間段內更新的黑名單信息條數。返回對象數據類型：int。返回值說明：0：查詢成功，數值為指定時間段內更新的黑名單信息條數-1：認證失敗-2：開始時間晚于截止時間-9

12、：系統異常2.9 下載指定時間段內更新的黑名單信息接口服務名：ProvService方法名：downloadBlackListByUpdateDate說明：時間段采用左閉右開區間，即fromTimetendTime中的時間t所在區間為指定時間段。2.9.1 請求參數序號參數名參數說明數據類型長度備注1strDistrictID省份代碼string6使用6位國標省份代碼2strTimeStamp時間戳string10以毫秒表示的當前時間3fromTime開始時間datetime4endTime截止時間datetime5pageNo下載頁碼int每次下載50條信息，按照頁碼確定是哪50條6strA

13、uth驗證信息string255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 282.9.2 返回信息返回對象：DownloadResult (參見第4.8節)其中retobj為Blinfo（參見第4.5節）2.10 查詢車輛違章次數接口服務名：ProvService方法名：getOeCountByVehicleId說明：時間段采用左閉右開區間，即fromTimetendTime中的時間t所在區間為指定時間段。2.10.1 請求參數序號參數名參數說明數據類型長度備注1strDistrictID省份代碼string31使用6位國標省份代碼2strTimestamp時間戳stri

14、ng10以毫秒計算3strVehicleId車牌號string314fromTime開始時間datetime5endTime截止時間datetime6strAuth驗證信息String255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 292.10.2 返回信息返回對象：指定時間區間內的違章次數。返回對象數據類型：int。返回值說明：0：查詢成功，數值為指定時間區間內的車輛違章次數-1：認證失敗-2：開始時間晚于截止時間-9：系統異常2.11 下載車輛違章詳細信息接口服務名：ProvService方法名：downloadOefullinfoByVehicleId說明：時間段采

15、用左閉右開區間，即fromTimetendTime中的時間t所在區間為指定時間段。2.11.1 請求參數序號參數名參數說明數據類型長度備注1strDistrictID省份代碼string31使用6位國標省份代碼2strTimestamp時間戳string10以毫秒計算3strVehicleId貨車牌號string314fromTime開始日期datetime5endTime截止日期datetime6strAuth驗證信息string255省份代碼+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 2102.11.2 返回信息返回對象：DownloadResult （參見第4.8節）其中 r

16、etobj 為 Oefullinfo （參見第4.6節）3 檢測站數據傳輸接口3.1 按車牌號查詢超限運輸許可接口服務名：StationService方法名：getOlinfoByVehicleId說明：根據車牌號碼，查詢該車的超限運輸許可證詳細信息。3.1.1 請求參數序號參數名參數說明數據類型長度備注1strStationID檢測站號string312strTimestamp時間戳string10以毫秒計算3strVehicleId貨車牌號string314strAuth驗證信息string255檢測站號+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 313.1.2 返回信息返回對

17、象：DownloadResult 參見第4.8節其中retobj為 Olinfo （參見第4.4節）3.2 按許可證號查詢超限運輸許可接口服務名：StationService方法名：getOlinfoByLicenseNo說明：根據超限許可證號，查詢該超限運輸許可證的詳細信息。3.2.1 請求參數序號參數名參數說明數據類型長度備注1strStationID檢測站號string312strTimestamp時間戳string10以毫秒計算3strLicenseNo許可證號String314strAuth驗證信息string255檢測站號+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 32

18、3.2.2 返回信息返回對象：DownloadResult 參見第4.8節其中retobj為 Olinfo （參見第4.4節）3.3 查詢車輛是否在黑名單并查詢超限次數接口服務名：StationService方法名：getOverLimitedTimes說明：查看指定車牌號碼的車輛被列入黑名單中的違章次數，同時可用于查詢車輛是否在黑名單中3.3.1 請求參數序號參數名參數說明數據類型長度備注1strStationID檢測站號string312strTimestamp時間戳string10以毫秒計算3strVehicleId貨車牌號String314strAuth驗證信息string255檢測站

19、號+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 333.3.2 返回信息返回對象：該車的違章次數，若返回0，表示該車不在黑名單列表中，大于0則表示該車已經進入黑名單。返回對象數據類型：int。返回值說明：0：查詢成功， -1：認證失敗-9：系統異常3.4 查詢車輛黑名單超限信息接口服務名：StationService方法名：getOverLimitedInfo說明：根據貨車牌號查詢該車輛在黑名單上記錄的的超限信息。3.4.1 請求參數序號參數名參數說明數據類型長度備注1strStationID檢測站號String312strTimestamp時間戳String10以毫秒計算3strV

20、ehicleId貨車牌號String314strAuth驗證信息string255檢測站號+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 343.4.2 返回信息返回對象： DownloadResult 參見第4.8節其中retobj 為 Oefullinfo （參見第4.2節）3.5 查詢車輛違章次數接口服務名：StationService方法名：getOeCountByVehicleId說明：時間段采用左閉右開區間，即fromTimetendTime中的時間t所在區間為指定時間段。3.5.1 請求參數序號參數名參數說明數據類型長度備注1strStationID省份代碼string3

21、12strTimestamp時間戳string10以毫秒計算3strVehicleId車牌號string314fromTime開始時間datetime5endTime截止時間datetime6strAuth驗證信息string255檢測站號+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 353.5.2 返回信息返回對象：該車在指定時間區間內的違章次數。返回對象數據類型：int。返回值說明：0：查詢成功，數值為指定時間區間內的車輛違章次數-1：認證失敗-2：開始時間晚于截止時間-9：系統異常3.6 下載車輛違章詳細信息接口服務名：ProvService方法名：downloadOefull

22、infoByVehicleId說明：時間段采用左閉右開區間，即fromTimetendTime中的時間t所在區間為指定時間段。3.6.1 請求參數序號參數名參數說明數據類型長度備注1strStationID省份代碼string312strTimestamp時間戳string10以毫秒計算3strVehicleId貨車牌號string314fromTime開始時間datetime5endTime截止時間datetime6strAuth驗證信息string255檢測站號+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 363.6.2 返回信息返回對象：DownloadResult （參見第4

23、.8節）其中 retobj 為 Oefullinfo （參見第4.6節）3.7 車輛基本信息查詢接口服務名：StationService方法名：getVehicleBaseinfo說明：根據車牌號碼查詢車輛基本信息。 3.7.1 請求參數序號參數名參數說明數據類型長度備注1strStationID檢測站號string312strTimestamp時間戳string10以毫秒計算3strVehicleId貨車牌號string314strAuth驗證信息string255檢測站號+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 373.7.2 返回信息返回對象：DownloadResult

24、參見第4.8節其中retobj 為VehicleBaseinfo （參見第4.9節）3.8 駕駛員信息查詢接口服務名：StationService方法名：getDriverBaseinfo說明：根據駕駛證號查詢駕駛員的基本信息。 3.8.1 請求參數序號參數名參數說明數據類型長度備注1strStationID檢測站號String312strTimestamp時間戳String10以毫秒計算3strDriverId駕駛證號String314strAuth驗證信息String255檢測站號+時間戳+密鑰（統一由部里發放），然后進行MD5計算表 383.8.2 返回信息返回對象：DownloadRe

25、sult 參見第4.8節其中retobj 為DriverBaseinfo （參見第4.10節）4 傳輸對象結構4.1 高速預檢信息Hspinfo序號字段名字段說明數據類型長度備注1hspid預檢序號string312hsptime檢測時間datetime3stationid檢測站號string314vehicleid貨車牌號string315vehicletype貨車類型int26axlesum軸數int27speed車速int38laneno車道int29totalweight總重int6單位為千克10overlimited超限量int6單位為千克11axle1軸重1int6單位為千克12a

26、xle2軸重2int6單位為千克13axle3軸重3int6單位為千克14axle4軸重4int6單位為千克15axle5軸重5int6單位為千克16axle6軸重6int6單位為千克17axle7軸重7int6單位為千克18axle8軸重8int6單位為千克19vehicleimage預檢圖片binary攝像頭拍照圖片4.2 低速精檢信息Lscinfo序號字段名字段說明數據類型長度備注1checkno檢測單號string312vehicleid貨車牌號string313axlesum軸數int24weightlimited車貨限重int6單位為千克5totalweight總質量int6單位為

27、千克，行駛證上標明的總質量6ratedloading核定載質量int6單位為千克，行駛證上標明的核定載質量7overlimited超限量int6單位為千克8overload超載量int6單位為千克，實際重量與行駛證標明總質量比較超出部分9fctime初檢時間datetimeFirst check time，下同10fclaneno初檢車道號int211fctotalweight初檢總重量int6單位為千克12fcoper初檢操作員string3113fcaxle1初檢軸重1int6單位為千克14fcaxle2初檢軸重2int6單位為千克15fcaxle3初檢軸重3int6單位為千克16fcax

28、le4初檢軸重4int6單位為千克17fcaxle5初檢軸重5int6單位為千克18fcaxle6初檢軸重6int6單位為千克19fcaxle7初檢軸重7int6單位為千克20fcaxle8初檢軸重8int6單位為千克21fclength初檢車貨總長int6單位為毫米22fcwidth初檢車貨總寬int6單位為毫米23fcheight初檢車貨總高int6單位為毫米24overlength超長量int6單位為毫米25overwidth超寬量int6單位為毫米26Overheight超高量int6單位為毫米27Rctime復檢時間datetimeRecheck time，下同28Rclaneno復

29、檢車道號int229rctotalweight復檢總重量int6單位為千克30Rcoper復檢操作員string3131rcaxle1復檢軸重1int6單位為千克32rcaxle2復檢軸重2int6單位為千克33rcaxle3復檢軸重3int6單位為千克34rcaxle4復檢軸重4int6單位為千克35rcaxle5復檢軸重5int6單位為千克36rcaxle6復檢軸重6int6單位為千克37rcaxle7復檢軸重7int6單位為千克38rcaxle8復檢軸重8int6單位為千克39Rclength復檢車貨總長int6單位為毫米40Rcwidth復檢車貨總寬int6單位為毫米41Rcheigh

30、t復檢車貨總高int6單位為毫米42Offload已卸載量int6單位為千克43fcvehicleimage初檢車頭圖片binary44rcvehicleimage復檢車頭圖片binary45stationid檢測站號string314.3 超限執法信息Oeinfo 序號字段名字段說明數據類型長度備注1oeid執法序號string31Overlimited enforcement ID2checkno檢測單號string313bizcertid道路運輸證號string634carriername承運人名稱string2555carrieraddr承運人地址string2556carrierpo

31、st承運人郵編string67lawpersonname法人代表姓名string318lawpersonidtype證件類型string10- 身份證1- 護照2- 其它9lawpersonid法人代表證件號碼string3110drivername司機姓名string3111driverid駕駛證號string3112qualificationid從業資格證號string3113drivergender司機性別string3填寫“男”或“女”14driverres司機戶籍string6315cargoname貨物名稱string12716cargotype貨物類別string417cargo

32、ownername貨主名稱string25518cargolawperson貨主法人代表string3119departure出發地區string25521destination目的地區string25522loadingaddr裝貨地址string25523punishno處罰書號string3124punishdate處罰日期date25punishamount罰款金額float12,226damageamount賠償金額float12,227enforcername1執法人1string3128enforcerid1執法人1證件號碼string3129enforcername2執法人2s

33、tring3130enforcerid2執法人2證件號碼string3131ismodified是否非法改裝string10-不是 1-是32modifydesc非法改裝說明string12733isnonstandard是否非標準車輛string10-不是 1-是34nonstandarddesc非標準車輛說明string12735isgreen是否綠色通道string10-不是 1-是37notes備注string2554.4 超限許可信息Olinfo 序號字段名字段說明數據類型長度備注1licenseno超限許可證號string312vehicleid貨車牌號string313bizce

34、rtid道路運輸證號string314axlesum軸數number25vehicleweight貨車重量int6單位為千克6vehicleoutline輪廓尺寸string1278speed規定車速int39departure出發地點string25510distinction目的地點string25511route經過路線string25512transportcycle運輸周期string12713carrier承運人名稱string25514lawperson法人代表string3115lawpersonidtp法人代表證件類型string31身份證-016lawpersonid法人代

35、表證件號碼string3117phoneno聯系電話string2018conferno承運協議號string12719cargoname貨物名稱string12720cargotype貨物類別string4使用國標貨物代碼21cargoweight貨物重量int6單位為千克22apart可否解體string10-不可，1-可23length車貨總長int6單位為毫米24width車貨總寬int6單位為毫米25height車貨總高int6單位為毫米26Notes備注string2554.5 黑名單信息Blinfo 序號字段名字段說明數據類型長度備注1vehicleid貨車牌號string312

36、vltimes違章次數int4Violation times3lastvldate最后違章日期datetime4updatedate更新日期datetime5bldate進入名單日期datetimeblack list date6operid最后操作標志string1A-新增;M-修改;D-刪除7status狀態string10-正常 1-從黑名單刪除4.6 違章詳細信息Oefullinfo序號字段名字段說明數據類型長度備注1checkno檢測單號string312oeid執法序號string313vehicleid貨車牌號string314axlesum軸數int25weightlimite

37、d車貨限重int6單位為千克6totalweight總質量int6單位為千克，行駛證上標明的總質量7ratedloading核定載質量int6單位為千克，行駛證上標明的核定載質量8overlimited超限量int6單位為千克9overload超載量Int6單位為千克，實際重量與行駛證標明總質量比較超出部分10fctime初檢時間datetime11fclaneno初檢車道號Int212fctotalweight初檢總重量Int6單位為千克13fcoper初檢操作員string3114fclength初檢車貨總長Int6單位為毫米15fcwidth初檢車貨總寬Int6單位為毫米16fcheig

38、ht初檢車貨總高int6單位為毫米17overlength超長量int6單位為毫米18overwidth超寬量int6單位為毫米19overheight超高量int6單位為毫米20rctime復檢時間datetimeRecheck time，下同21rclaneno復檢車道號int222rctotalweight復檢總重量int6單位為千克23rcoper復檢操作員string3124rclength復檢車貨總長int6單位為毫米25rcwidth復檢車貨總寬int6單位為毫米26rcheight復檢車貨總高int6單位為毫米27offload已卸載量int6單位為千克28fcvehiclei

39、mage初檢車頭圖片binaryrcvehicleimage復檢車頭圖片binary29stationid檢測站號string3130bizcertid道路運輸證號string6331crarriename承運人名稱string25532carrieraddr承運人地址string25533carrierpost承運人郵編string634lawpersonname法人代表姓名string3135lawpersonidtype證件類型string10-身份證36lawpersonid法人代表證件號碼string3137drivername司機姓名string3138driverid駕駛證號st

40、ring3139qualificationid從業資格證號string3140drivergender司機性別string3填寫“男”或“女”41driverres司機戶籍string6342cargoname貨物名稱string12743cargotype貨物類別string444cargoownername貨主名稱string25545cargolawperson貨主法人代表string3146departure出發地區string25547destination目的地區string25548loadingaddr裝貨地址string25549punishno處罰書號string3150punishtime處罰時間datetime51punis