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

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

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

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

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

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

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

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

8、動車信息交換9.寫機(jī)動車業(yè)務(wù)移交信息【1】寫機(jī)動車業(yè)務(wù)日志表信息【2】更新機(jī)動車業(yè)務(wù)表管理部門機(jī)動車信息交換10.寫機(jī)動車所有人聯(lián)系方式機(jī)動車信息交換11.寫臨時(shí)號牌信息機(jī)動車信息交換12.寫機(jī)動車排隊(duì)信息機(jī)動車信息交換13.寫機(jī)動車報(bào)廢中間表機(jī)動車信息交換14.駕駛證相關(guān)信息讀取接口【1】讀取駕校信息【2】讀取教練車信息【3】讀取考試場地信息【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.寫預(yù)錄入信息接口【1】初次申領(lǐng)業(yè)務(wù)預(yù)錄入接口【2】體檢信息預(yù)錄入接口駕駛證信息交換16.考試相關(guān)信息寫入接口【1】預(yù)約信息寫入接口【2】科目二成績寫入接口【3】科目三成績寫入接口駕駛證信息交換17.駕駛證業(yè)務(wù)信息寫入接口【1】收費(fèi)信息寫入接口【2】業(yè)務(wù)日志寫入接口【3】業(yè)務(wù)移交信息寫入接口【4】業(yè)務(wù)預(yù)警信息寫入接口駕駛證信息交換18.駕駛證信息更新接口【1】駕駛?cè)苏掌瑢懭虢涌凇?】駕駛?cè)寺?lián)系信息更新接口駕駛證信息交換19.違法業(yè)務(wù)信息查詢接口【1】查詢違法基本信息【2】查詢制措施憑證（違法處理通知書）【3】查詢電子監(jiān)控文

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

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