1、交通管理綜合應(yīng)用平臺(tái)外掛系統(tǒng)請(qǐng)求服務(wù)接口使用手冊(cè)目錄第一部分 接口調(diào)用規(guī)范- 3 -1.1.接口訪(fǎng)問(wèn)地址- 3 -1.2.接口調(diào)用函數(shù)- 3 -1.2.1.查詢(xún)類(lèi)接口- 3 -1.2.2.寫(xiě)入類(lèi)接口- 4 -1.3.XML文件格式定義- 4 -1.3.1.查詢(xún)類(lèi)接口XML文檔- 4 -1.3.2.寫(xiě)入類(lèi)接口XML文檔- 5 -1.4.調(diào)用注意事項(xiàng)- 5 -1.4.1.XML文檔的中文處理- 5 -1.4.2.返回結(jié)果錯(cuò)誤代碼說(shuō)明- 6 -第二部分 外掛系統(tǒng)接口說(shuō)明- 7 -1.接口說(shuō)明- 7 -2.接口列表- 7 -2.1.機(jī)動(dòng)車(chē)接口定義- 11 -第一部分 接口調(diào)用規(guī)范1.1. 接口訪(fǎng)問(wèn)地址

2、外掛系統(tǒng)請(qǐng)求服務(wù)的接口訪(fǎng)問(wèn)地址：http:/ip:port/ trffweb/services/TmriOutAccess?wsdl其中IP標(biāo)識(shí)Web服務(wù)器地址；port對(duì)應(yīng)系統(tǒng)應(yīng)用服務(wù)的端口號(hào)，啟用80的不填寫(xiě)。1.2. 接口調(diào)用函數(shù)外掛系統(tǒng)請(qǐng)求服務(wù)平臺(tái)的接口包括兩類(lèi)：查詢(xún)類(lèi)和寫(xiě)入類(lèi)接口。查詢(xún)類(lèi)接口對(duì)外提供查詢(xún)服務(wù)，寫(xiě)入類(lèi)接口對(duì)外提供將業(yè)務(wù)數(shù)據(jù)寫(xiě)入綜合應(yīng)用平臺(tái)業(yè)務(wù)庫(kù)。1.2.1. 查詢(xún)類(lèi)接口public StringqueryObjectOut(Stringxtlb,String jkxlh,String jkid,String QueryXmlDoc);表1：查詢(xún)類(lèi)接口調(diào)用參數(shù)說(shuō)明序號(hào)參數(shù)

3、名稱(chēng)參數(shù)說(shuō)明備注信息1xtlb系統(tǒng)類(lèi)別接口提供者的業(yè)務(wù)類(lèi)別代碼，如機(jī)動(dòng)車(chē)登記業(yè)務(wù)：01，駕駛證管理業(yè)務(wù)：02，事故處理：03，違法處理：04，交警隊(duì)平臺(tái)：05，劇毒品業(yè)務(wù)：062jkxlh接口序列號(hào)由外掛系統(tǒng)請(qǐng)求服務(wù)平臺(tái)授權(quán)生成下發(fā)3jkid接口標(biāo)識(shí)5位，由系統(tǒng)類(lèi)別一位級(jí)別代碼兩位接口順序號(hào)組成(參照監(jiān)管系統(tǒng))，C：支隊(duì)、B:總隊(duì)，A：部局。如01A01代表機(jī)動(dòng)車(chē)部局端提供的接口。定義時(shí)查詢(xún)類(lèi)接口順序號(hào)取50以?xún)?nèi)的數(shù)字，寫(xiě)入接口順序號(hào)定義為50以上的數(shù)字。4QueryXmlDoc查詢(xún)條件封裝查詢(xún)條件的XML格式文檔1.2.2. 寫(xiě)入類(lèi)接口Public String writeObjectOut

4、 (String xtlb,String jkxlh,String jkid;String WriteXmlDoc)表2 寫(xiě)入類(lèi)接口調(diào)用參數(shù)說(shuō)明序號(hào)參數(shù)名稱(chēng)參數(shù)說(shuō)明備注信息1xtlb系統(tǒng)類(lèi)別同上2jkxlh接口序列號(hào)同上3jkid接口標(biāo)識(shí)同上4WriteXmlDoc寫(xiě)入數(shù)據(jù)業(yè)務(wù)數(shù)據(jù)寫(xiě)入XML格式文檔1.3. XML文件格式定義1.3.1. 查詢(xún)類(lèi)接口XML文檔查詢(xún)條件QueryXmlDoc的文檔格式要求如下：查詢(xún)返回結(jié)果XML文檔格式1.3.2. 寫(xiě)入類(lèi)接口XML文檔寫(xiě)入數(shù)據(jù)WriteXmlDoc文檔格式如下：寫(xiě)入操作返回結(jié)果文檔格式如下：1.4. 調(diào)用注意事項(xiàng)1.4.1. XML文檔的中文處

5、理（1）接口查詢(xún)結(jié)果進(jìn)行過(guò)URLDecoder和UTF-8編碼處理,須進(jìn)行轉(zhuǎn)換（轉(zhuǎn)換函數(shù)為URLDecoder.decode(str, utf-8);）才能正常讀取；（2）寫(xiě)入信息中文字符必須URLEncoder成utf-8格式（轉(zhuǎn)換函數(shù)為URLEncoder.encode(xmlDoc, utf-8)；）后再封裝成XML文檔。（3）XML文檔的【寫(xiě)入數(shù)據(jù)字段】和【返回結(jié)果字段】的標(biāo)簽均為小寫(xiě)字符。XML文檔【節(jié)點(diǎn)標(biāo)簽】必須和手冊(cè)中注明的保持一致。1.4.2. 返回結(jié)果錯(cuò)誤代碼說(shuō)明正常返回結(jié)果code為成功與否標(biāo)記（0、失敗；1、成功或其他，由提供的接口服務(wù)定義），網(wǎng)絡(luò)異常或接口權(quán)限異常等系統(tǒng)

6、原因時(shí)返回$E的標(biāo)記。寫(xiě)入失敗時(shí)的message返回詳細(xì)描述信息。第二部分 外掛系統(tǒng)接口說(shuō)明1. 接口說(shuō)明2. 接口列表外掛請(qǐng)求服務(wù)平臺(tái)提供的信息接口共47個(gè)，見(jiàn)下表,其中寫(xiě)照片接口(紅色字體顯示)參考第四部分。序號(hào)接口名稱(chēng)接口定義提供者接口類(lèi)型1.機(jī)動(dòng)車(chē)信息讀取接口【1】讀取機(jī)動(dòng)車(chē)基本信息【2】讀取機(jī)動(dòng)車(chē)在辦業(yè)務(wù)信息【3】通過(guò)流水號(hào)讀機(jī)動(dòng)車(chē)流水表信息【4】通過(guò)號(hào)牌號(hào)碼讀機(jī)動(dòng)車(chē)流水表信息【5】讀取機(jī)動(dòng)車(chē)業(yè)務(wù)日志信息【6】讀取機(jī)動(dòng)車(chē)證件打印信息【7】讀取轉(zhuǎn)出注銷(xiāo)機(jī)動(dòng)車(chē)信息【8】讀取機(jī)動(dòng)車(chē)查封信息【9】讀取新機(jī)動(dòng)車(chē)序列序號(hào)【10】獲取新機(jī)動(dòng)車(chē)業(yè)務(wù)流水號(hào)【11】獲取機(jī)動(dòng)車(chē)下一檢驗(yàn)有效期止機(jī)動(dòng)車(chē)信息復(fù)

7、用2.寫(xiě)機(jī)動(dòng)車(chē)檢驗(yàn)信息【1】寫(xiě)機(jī)動(dòng)車(chē)檢驗(yàn)結(jié)果信息【2】寫(xiě)入機(jī)動(dòng)車(chē)檢驗(yàn)詳細(xì)信息【3】寫(xiě)入機(jī)動(dòng)車(chē)制動(dòng)力曲線(xiàn)表機(jī)動(dòng)車(chē)信息交換3.寫(xiě)機(jī)動(dòng)車(chē)選號(hào)信息【1】寫(xiě)機(jī)動(dòng)車(chē)選號(hào)信息（總隊(duì)版）【2】寫(xiě)機(jī)動(dòng)車(chē)選號(hào)信息（支隊(duì)版）機(jī)動(dòng)車(chē)信息交換4.寫(xiě)機(jī)動(dòng)車(chē)收費(fèi)信息【1】寫(xiě)機(jī)動(dòng)車(chē)收費(fèi)信息【2】刪除機(jī)動(dòng)車(chē)收費(fèi)信息機(jī)動(dòng)車(chē)信息交換5.寫(xiě)機(jī)動(dòng)車(chē)預(yù)錄入信息機(jī)動(dòng)車(chē)信息交換6.寫(xiě)機(jī)動(dòng)車(chē)中間表信息【1】寫(xiě)入機(jī)動(dòng)車(chē)保險(xiǎn)信息【2】寫(xiě)入機(jī)動(dòng)車(chē)抵押信息【3】寫(xiě)入機(jī)動(dòng)車(chē)納稅信息機(jī)動(dòng)車(chē)信息交換7.寫(xiě)機(jī)動(dòng)車(chē)檔案編號(hào)【1】寫(xiě)機(jī)動(dòng)車(chē)臨時(shí)表檔案編號(hào)【2】寫(xiě)機(jī)動(dòng)車(chē)主表檔案編號(hào)機(jī)動(dòng)車(chē)信息交換8.寫(xiě)機(jī)動(dòng)車(chē)照片信息【1】寫(xiě)機(jī)動(dòng)車(chē)照片信息【2】寫(xiě)機(jī)動(dòng)車(chē)照片中間表信息機(jī)

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

9、信息【14】讀取打印歷史記錄【15】讀取駕駛?cè)嘶拘畔Ⅰ{駛證信息復(fù)用15.寫(xiě)預(yù)錄入信息接口【1】初次申領(lǐng)業(yè)務(wù)預(yù)錄入接口【2】體檢信息預(yù)錄入接口駕駛證信息交換16.考試相關(guān)信息寫(xiě)入接口【1】預(yù)約信息寫(xiě)入接口【2】科目二成績(jī)寫(xiě)入接口【3】科目三成績(jī)寫(xiě)入接口駕駛證信息交換17.駕駛證業(yè)務(wù)信息寫(xiě)入接口【1】收費(fèi)信息寫(xiě)入接口【2】業(yè)務(wù)日志寫(xiě)入接口【3】業(yè)務(wù)移交信息寫(xiě)入接口【4】業(yè)務(wù)預(yù)警信息寫(xiě)入接口駕駛證信息交換18.駕駛證信息更新接口【1】駕駛?cè)苏掌瑢?xiě)入接口【2】駕駛?cè)寺?lián)系信息更新接口駕駛證信息交換19.違法業(yè)務(wù)信息查詢(xún)接口【1】查詢(xún)違法基本信息【2】查詢(xún)制措施憑證（違法處理通知書(shū)）【3】查詢(xún)電子監(jiān)控文

10、本信息【4】查詢(xún)電子監(jiān)控照片信息【5】查詢(xún)?nèi)罩拘畔ⅰ?】查詢(xún)銀行對(duì)賬信息違法信息復(fù)用20.銀行對(duì)賬錄入接口違法信息交換21.電子監(jiān)控錄入接口【1】電子監(jiān)控錄入接口（已審核）【2】電子監(jiān)控錄入接口（未審核）違法信息交換22.簡(jiǎn)易處罰決定書(shū)寫(xiě)入接口違法信息交換23.強(qiáng)制措施（違法處理通知書(shū)）寫(xiě)入接口違法信息交換24.電子監(jiān)控簡(jiǎn)易程序處理寫(xiě)入接口違法信息交換25.行政拘留回執(zhí)信息寫(xiě)入接口違法信息交換26.銀行對(duì)賬罰款收據(jù)編號(hào)修改接口違法信息交換27.注銷(xiāo)最高實(shí)習(xí)準(zhǔn)駕車(chē)型業(yè)務(wù)通知信息寫(xiě)入接口違法信息交換28.讀取刑事案件事故信息事故信息復(fù)用29.寫(xiě)110接警信息事故信息交換30.寫(xiě)簡(jiǎn)易事故信息事故信息

11、交換31.寫(xiě)現(xiàn)場(chǎng)圖圖片信息事故信息交換32.寫(xiě)GIS電子坐標(biāo)信息事故信息交換33.寫(xiě)刑事案件基本結(jié)果信息事故信息交換34.寫(xiě)詢(xún)問(wèn)筆錄信息事故信息交換35.寫(xiě)談話(huà)記錄信息事故信息交換36.查詢(xún)套牌/假牌機(jī)動(dòng)車(chē)信息警務(wù)信息信息復(fù)用37.查詢(xún)告知信息【1】查詢(xún)機(jī)動(dòng)車(chē)告知信息【2】查詢(xún)駕駛?cè)烁嬷畔ⅰ?】查詢(xún)機(jī)動(dòng)車(chē)三同和多次告知信息【4】查詢(xún)機(jī)動(dòng)車(chē)非現(xiàn)場(chǎng)違法告知信息警務(wù)信息信息復(fù)用38.寫(xiě)套牌/假牌機(jī)動(dòng)車(chē)信息警務(wù)信息信息交換39.查詢(xún)客貨運(yùn)駕駛?cè)诵畔⑿畔⒕瘎?wù)信息信息復(fù)用40.寫(xiě)機(jī)動(dòng)車(chē)待辦業(yè)務(wù)已告知警務(wù)信息信息交換41.寫(xiě)駕駛?cè)舜k業(yè)務(wù)已告知警務(wù)信息信息交換42.寫(xiě)機(jī)動(dòng)車(chē)三同和多次違法已告知警務(wù)信息信息交換43.寫(xiě)機(jī)動(dòng)車(chē)非現(xiàn)場(chǎng)違法已告知警務(wù)信息信息交換44.寫(xiě)勤務(wù)臺(tái)賬信息警務(wù)信息信息交換45.寫(xiě)機(jī)動(dòng)車(chē)套牌車(chē)圖片信息警務(wù)信息信息交換46.讀取通行