六合一綜合平臺外掛系統(tǒng)接口使用手冊

1、交通管理綜合應用平臺外掛系統(tǒng)請求服務 接口使用手冊目錄 第一部分 接口調(diào)用規(guī)范 . . 1.1. 接口訪問地址 . 1.2. 接口調(diào)用函數(shù) . 查詢類接口 . 寫入類接口 . 1.3. XML 文件格式定義 . . 查詢類接口 XML 文檔 . 寫入類接口 XML 文檔 . 1.4. 調(diào)用注意事項 . XML 文檔的中文處理 . 返回結果錯誤代碼說明 . 第二部分 外掛系統(tǒng)接口說明 . . 1. 接口說明 . 2. 接口列表 . 2.1. 機動車接口定義 . .第一部分接口調(diào)用規(guī)范 1.1. 接口訪問地址 外掛系統(tǒng)請求服務的接口訪問地址： trffweb/services/TmriOutAcc

2、ess?wsdl 其中IP標識Web服務器地址；port對應系統(tǒng)應用服務的端口 號，啟用80的不填寫。 1.2. 接口調(diào)用函數(shù) 外掛系統(tǒng)請求服務平臺的接口包括兩類：查詢類和寫入類接 口。查詢類接口對外提供查詢服務，寫入類接口對外提供將業(yè)務 數(shù)據(jù)寫入綜合應用平臺業(yè)務庫。 1.2.1. 查詢類接口 public StringqueryObjectOut(Stringxtlb,String jkxlh,String jkid,String QueryXmlDoc); 表1:查詢類接口調(diào)用參數(shù)說明 序號 參數(shù)名稱 參數(shù)說明 備注信息 1 1 xtlbxtlb 系統(tǒng)類別 接口提供者的業(yè)務類別代碼， 如機

3、動車登記業(yè)務：0101,駕駛證管理業(yè)務：0202,事 故處理：0303,違法處理：0404,交警隊平臺：0505，劇 毒品業(yè)務：0606 2 2 jkxlhjkxlh 接口序列號 由外掛系統(tǒng)請求服務平臺授權生成下發(fā) 3 3 jkidjkid 接口標識 5 5 位，由系統(tǒng)類別+ 位級別代碼+兩位接口順序 號組成（參照監(jiān)管系統(tǒng)）,C C:支隊、B:B:總隊，A A :部 局。如01A0101A01 代表機動車部局端提供的接口。 定義 時查詢類接口順序號取 5050 以內(nèi)的數(shù)字，寫入接口 順序號定義為 5050 以上的數(shù)字。 4 4 QueryXmlDocQueryXmlDoc 查詢條件 封裝查詢條

4、件的 XMLXML 格式文檔 122.寫入類接口 Public String writeObjectOut (String xtlb,String jkxlh,String jkid;String WriteXmlDoc) 表2寫入類接口調(diào)用參數(shù)說明 序號 參數(shù)名稱 參數(shù)說明 備注信息 1 1 xtlbxtlb 系統(tǒng)類別 同上 2 2 jkxlhjkxlh 接口序列號 同上 3 3 jkidjkid 接口標識 同上 4 4 WriteXmlDocWriteXmlDoc 寫入數(shù)據(jù) 業(yè)務數(shù)據(jù)寫入 XMLXML 格式文檔 1.3. XML文件格式定義 1.3.1. 查詢類接口 XML 文檔 查詢條件

5、 QueryXmlDoc的文檔格式要求如下: 查詢返回結果XML文檔格式 1.3.2. 寫入類接口 XML 文檔 寫入數(shù)據(jù) WriteXmlDoc文檔格式如下： 寫入操作返回結果文檔格式如下： 1.4. 調(diào)用注意事項 1.4.1. XML 文檔的中文處理 （1）接口查詢結果進行過 URLDecoder和UTF-8編碼處理，須 進行轉(zhuǎn)換（轉(zhuǎn)換函數(shù)為 URLDecoder.decode（str, utf-8）; ）才 能正常讀?。?寫入信息中文字符必須 URLEncoder成utf-8 格式(轉(zhuǎn) 換函數(shù)為 URLEncoder.encode(xmlDoc, utf-8) ；后再圭寸裝成 XML文檔

6、。 XML文檔的【寫入數(shù)據(jù)字段】和【返回結果字段】的標 簽均為小寫字符。XML文檔【節(jié)點標簽】必須和手冊中注明的保 持致。 1.4.2. 返回結果錯誤代碼說明 正常返回結果code為成功與否標記(0、失??；1、成功或其 他，由提供的接口服務定義)，網(wǎng)絡異?；蚪涌跈嘞蕻惓５认到y(tǒng)原 因時返回$E的標記。寫入失敗時的 message返回詳細描述信息。第二部分外掛系統(tǒng)接口說明 1.接口說明 2.接口列表 外掛請求服務平臺提供的信息接口共 47個，見下表，其中寫 照片接口（紅色字體顯示）參考第四部分 序號 接口名稱 接口定義 提供者 接口類型 1. 機動車信息讀取接口 【1 1】讀取機動車基本信息 【2

7、 2】讀取機動車在辦業(yè)務信息 【3 3】通過流水號讀機動車流水表信息 【4 4】通過號牌號碼讀機動車流水表信息 【5 5】讀取機動車業(yè)務日志信息 【6 6】讀取機動車證件打印信息 【7 7】讀取轉(zhuǎn)岀注銷機動車信息 【8 8】讀取機動車查封信息 【9 9】讀取新機動車序列序號 【1010】獲取新機動車業(yè)務流水號 【1111】獲取機動車下一檢驗有效期止 機動車 信息復用 2. 寫機動車檢驗信息 【1 1】寫機動車檢驗結果信息 【2 2】寫入機動車檢驗詳細信息 【3 3】寫入機動車制動力曲線表 機動車 信息交換 3. 與機動車選號信息 【1 1】寫機動車選號信息（總隊版） 【2 2】寫機動車選號信息

8、（支隊版） 機動車 信息交換 4. 寫機動車收費信息 【1 1】寫機動車收費信息 【2 2】刪除機動車收費信息 機動車 信息交換 5. 寫機動車預錄入信息 機動車 信息交換 6. 寫機動車中間表信息 【1 1】寫入機動車保險信息 【2 2】寫入機動車抵押信息 【3 3】寫入機動車納稅信息 機動車 信息交換 7. 寫機動車檔案編號 【1 1】寫機動車臨時表檔案編號 【2 2】寫機動車主表檔案編號 機動車 信息交換 8. 寫機動車照片信息 【1 1】寫機動車照片信息 【2 2】寫機動車照片中間表信息 機動車 信息交換 9. 寫機動車業(yè)務移交信息 【1 1】寫機動車業(yè)務日志表信息 【2 2】更新機動

9、車業(yè)務表管理部門 機動車 信息交換 10. 寫機動車所有人聯(lián)系方式 機動車 信息交換 11. 寫臨時號牌信息 機動車 信息交換 12. 寫機動車排隊信息 機動車 信息交換 13. 寫機動車報廢中間表 機動車 信息交換 14. 駕駛證相關信息讀取接口 【1 1】讀取駕校信息 【2 2】讀取教練車信息 【3 3】讀取考試場地信息 【4 4】讀取考試員信息 【5 5】讀取駕駛人照片信息 【6 6】讀取考試計劃分組信息 【7 7】讀取考試計劃分組明細信息 【8 8】讀取考試預約信息 【9 9】讀取駕駛證基本信息 【1010】讀取駕駛證業(yè)務流水信息 【1111】讀取駕駛證在辦業(yè)務流水信息 【1212】讀

10、取準考證明信息 【1313】讀取業(yè)務日志信息 【1414】讀取打印歷史記錄 【1515】讀取駕駛人基本信息 駕駛證 信息復用 15. 寫預錄入信息接口 【1 1】初次申領業(yè)務預錄入接口 【2 2】體檢信息預錄入接口 駕駛證 信息交換 16. 考試相關信息寫入接口 【1 1】預約信息寫入接口 【2 2】科目二成績寫入接口 【3 3】科目三成績寫入接口 駕駛證 信息交換 17. 駕駛證業(yè)務信息寫入接口 【1 1】收費信息寫入接口 【2 2】業(yè)務日志寫入接口 【3 3】業(yè)務移交信息寫入接口 【4 4】業(yè)務預警信息寫入接口 駕駛證 信息交換 18. 駕駛證信息更新接口 【1 1】駕駛人照片寫入接口 【

11、2 2】駕駛人聯(lián)系信息更新接口 駕駛證 信息交換 19. 違法業(yè)務信息查詢接口 【1 1】查詢違法基本信息 【2 2】查詢制措施憑證（違法處理通知書） 【3 3】查詢電子監(jiān)控文本信息 【4 4】查詢電子監(jiān)控照片信息 【5 5】查詢?nèi)罩拘畔?【6 6】查詢銀行對賬信息 違法 信息復用 20. 銀行對賬錄入接口 違法 信息交換 21. 電子監(jiān)控錄入接口 【1 1】電子監(jiān)控錄入接口（已審核） 【2 2】電子監(jiān)控錄入接口（未審核） 違法 信息交換 22. 簡易處罰決定書寫入接口 違法 信息交換 23. 強制措施（違法處理通知 書）寫入接口 違法 信息交換 24. 電子監(jiān)控簡易程序處理寫 入接口 違法

12、信息交換 25. 行政拘留回執(zhí)信息寫入接 口 違法 信息交換 26. 銀行對賬罰款收據(jù)編號修 改接口 違法 信息交換 27. 注銷最高實習準駕車型業(yè) 務通知信息寫入接口 違法 信息交換 28. 讀取刑事案件事故信息 事故 信息復用 29. 寫 110 接警信息 事故 信息交換 30. 寫簡易事故信息 事故 信息交換 31. 寫現(xiàn)場圖圖片信息 事故 信息交換 32. 寫 GIS 電子坐標信息 事故 信息交換 33. 寫刑事案件基本結果信息 事故 信息交換 34. 寫詢問筆錄信息 事故 信息交換 35. 寫談話記錄信息 事故 信息交換 36. 查詢套牌/假牌機動車信息 警務信息 信息復用 37.

13、查詢告知信息 【1 1】查詢機動車告知信息 【2 2】查詢駕駛人告知信息 【3 3】查詢機動車三同和多次告知信息 【4 4】查詢機動車非現(xiàn)場違法告知信息 警務信息 信息復用 38. 寫套牌/假牌機動車信息 警務信息 信息交換 39. 查詢客貨運駕駛人信息信 息 警務信息 信息復用 40. 寫機動車待辦業(yè)務已告知 警務信息 信息交換 41. 寫駕駛人待辦業(yè)務已告知 警務信息 信息交換 42. 寫機動車三同和多次違法 已告知 警務信息 信息交換 43. 寫機動車非現(xiàn)場違法已告 知 警務信息 信息交換 44. 寫勤務臺賬信息 警務信息 信息交換 45. 寫機動車套牌車圖片信息 警務信息 信息交換 46. 讀取通行證