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

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

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

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

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

5、 QueryXmlDoc的文檔格式要求如下: 查詢返回結(jié)果XML文檔格式 1.3.2. 寫入類接口 XML 文檔 寫入數(shù)據(jù) WriteXmlDoc文檔格式如下： 寫入操作返回結(jié)果文檔格式如下： 1.4. 調(diào)用注意事項(xiàng) 1.4.1. XML 文檔的中文處理 （1）接口查詢結(jié)果進(jìn)行過 URLDecoder和UTF-8編碼處理，須 進(jìn)行轉(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ù)字段】和【返回結(jié)果字段】的標(biāo) 簽均為小寫字符。XML文檔【節(jié)點(diǎn)標(biāo)簽】必須和手冊(cè)中注明的保 持致。 1.4.2. 返回結(jié)果錯(cuò)誤代碼說明 正常返回結(jié)果code為成功與否標(biāo)記(0、失?。?、成功或其 他，由提供的接口服務(wù)定義)，網(wǎng)絡(luò)異?；蚪涌跈?quán)限異常等系統(tǒng)原 因時(shí)返回$E的標(biāo)記。寫入失敗時(shí)的 message返回詳細(xì)描述信息。第二部分外掛系統(tǒng)接口說明 1.接口說明 2.接口列表 外掛請(qǐng)求服務(wù)平臺(tái)提供的信息接口共 47個(gè)，見下表，其中寫 照片接口（紅色字體顯示）參考第四部分 序號(hào) 接口名稱 接口定義 提供者 接口類型 1. 機(jī)動(dòng)車信息讀取接口 【1 1】讀取機(jī)動(dòng)車基本信息 【2

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

8、（支隊(duì)版） 機(jī)動(dòng)車 信息交換 4. 寫機(jī)動(dòng)車收費(fèi)信息 【1 1】寫機(jī)動(dòng)車收費(fèi)信息 【2 2】刪除機(jī)動(dòng)車收費(fèi)信息 機(jī)動(dòng)車 信息交換 5. 寫機(jī)動(dòng)車預(yù)錄入信息 機(jī)動(dòng)車 信息交換 6. 寫機(jī)動(dòng)車中間表信息 【1 1】寫入機(jī)動(dòng)車保險(xiǎn)信息 【2 2】寫入機(jī)動(dòng)車抵押信息 【3 3】寫入機(jī)動(dòng)車納稅信息 機(jī)動(dòng)車 信息交換 7. 寫機(jī)動(dòng)車檔案編號(hào) 【1 1】寫機(jī)動(dòng)車臨時(shí)表檔案編號(hào) 【2 2】寫機(jī)動(dòng)車主表檔案編號(hào) 機(jī)動(dòng)車 信息交換 8. 寫機(jī)動(dòng)車照片信息 【1 1】寫機(jī)動(dòng)車照片信息 【2 2】寫機(jī)動(dòng)車照片中間表信息 機(jī)動(dòng)車 信息交換 9. 寫機(jī)動(dòng)車業(yè)務(wù)移交信息 【1 1】寫機(jī)動(dòng)車業(yè)務(wù)日志表信息 【2 2】更新機(jī)動(dòng)

9、車業(yè)務(wù)表管理部門 機(jī)動(dòng)車 信息交換 10. 寫機(jī)動(dòng)車所有人聯(lián)系方式 機(jī)動(dòng)車 信息交換 11. 寫臨時(shí)號(hào)牌信息 機(jī)動(dòng)車 信息交換 12. 寫機(jī)動(dòng)車排隊(duì)信息 機(jī)動(dòng)車 信息交換 13. 寫機(jī)動(dòng)車報(bào)廢中間表 機(jī)動(dòng)車 信息交換 14. 駕駛證相關(guān)信息讀取接口 【1 1】讀取駕校信息 【2 2】讀取教練車信息 【3 3】讀取考試場(chǎng)地信息 【4 4】讀取考試員信息 【5 5】讀取駕駛?cè)苏掌畔?【6 6】讀取考試計(jì)劃分組信息 【7 7】讀取考試計(jì)劃分組明細(xì)信息 【8 8】讀取考試預(yù)約信息 【9 9】讀取駕駛證基本信息 【1010】讀取駕駛證業(yè)務(wù)流水信息 【1111】讀取駕駛證在辦業(yè)務(wù)流水信息 【1212】讀

10、取準(zhǔn)考證明信息 【1313】讀取業(yè)務(wù)日志信息 【1414】讀取打印歷史記錄 【1515】讀取駕駛?cè)嘶拘畔?駕駛證 信息復(fù)用 15. 寫預(yù)錄入信息接口 【1 1】初次申領(lǐng)業(yè)務(wù)預(yù)錄入接口 【2 2】體檢信息預(yù)錄入接口 駕駛證 信息交換 16. 考試相關(guān)信息寫入接口 【1 1】預(yù)約信息寫入接口 【2 2】科目二成績(jī)寫入接口 【3 3】科目三成績(jī)寫入接口 駕駛證 信息交換 17. 駕駛證業(yè)務(wù)信息寫入接口 【1 1】收費(fèi)信息寫入接口 【2 2】業(yè)務(wù)日志寫入接口 【3 3】業(yè)務(wù)移交信息寫入接口 【4 4】業(yè)務(wù)預(yù)警信息寫入接口 駕駛證 信息交換 18. 駕駛證信息更新接口 【1 1】駕駛?cè)苏掌瑢懭虢涌?【

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

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

13、查詢告知信息 【1 1】查詢機(jī)動(dòng)車告知信息 【2 2】查詢駕駛?cè)烁嬷畔?【3 3】查詢機(jī)動(dòng)車三同和多次告知信息 【4 4】查詢機(jī)動(dòng)車非現(xiàn)場(chǎng)違法告知信息 警務(wù)信息 信息復(fù)用 38. 寫套牌/假牌機(jī)動(dòng)車信息 警務(wù)信息 信息交換 39. 查詢客貨運(yùn)駕駛?cè)诵畔⑿?息 警務(wù)信息 信息復(fù)用 40. 寫機(jī)動(dòng)車待辦業(yè)務(wù)已告知 警務(wù)信息 信息交換 41. 寫駕駛?cè)舜k業(yè)務(wù)已告知 警務(wù)信息 信息交換 42. 寫機(jī)動(dòng)車三同和多次違法 已告知 警務(wù)信息 信息交換 43. 寫機(jī)動(dòng)車非現(xiàn)場(chǎng)違法已告 知 警務(wù)信息 信息交換 44. 寫勤務(wù)臺(tái)賬信息 警務(wù)信息 信息交換 45. 寫機(jī)動(dòng)車套牌車圖片信息 警務(wù)信息 信息交換 46. 讀取通行證