深圳市網(wǎng)絡(luò)預(yù)約出租汽車監(jiān)管系統(tǒng)

1、人證車證核驗(yàn)接口協(xié)議二0一八年十二月1 .交換規(guī)則1.1. 設(shè)計(jì)原則為避免網(wǎng)約車監(jiān)管平臺(tái)與網(wǎng)約車公司平臺(tái)互為服務(wù)端進(jìn)行雙向通 信時(shí)帶來的部署方式局限，接口協(xié)議設(shè)計(jì)時(shí)盡量采用網(wǎng)約車監(jiān)管平臺(tái) 為服務(wù)端的模式。單一服務(wù)端的設(shè)計(jì)方式有利于接口服務(wù)的“微服務(wù)” 化，方便后期業(yè)務(wù)發(fā)展帶來的接口擴(kuò)展。1.2. 協(xié)議標(biāo)準(zhǔn)內(nèi)網(wǎng)數(shù)據(jù)傳輸采用HTTP/HTTP創(chuàng)、議標(biāo)準(zhǔn)，互聯(lián)網(wǎng)數(shù)據(jù)傳輸采 用 HTTPS基于HTTP POSTy式進(jìn)行數(shù)據(jù)請(qǐng)求，編碼格式統(tǒng)一為UTF-8編 碼。協(xié)議對(duì)HTTP協(xié)議做適當(dāng)擴(kuò)充，但不改變已有HTTP標(biāo)準(zhǔn)的任 何定義，實(shí)現(xiàn)者可以充分利用實(shí)現(xiàn)語言的HTTP開發(fā)包。1.3. 傳輸協(xié)議說明Reque

2、st:請(qǐng)求屬性名值（示例）必填備注RequestHeadersbinfile-md5請(qǐng)求文件二進(jìn)制流的MD5摘要，示例：bcf7837571fab538772f65b137b71b9dM文件 md5摘要，附于數(shù)據(jù)完 整性校驗(yàn)binfile-gzitrue 或者 flaseO響應(yīng)是否采用 GZIP壓縮Pbinfile-aut hTICKETM單位標(biāo)識(shí)鑒權(quán)（格式：16位 英文字符串，不區(qū)分大小與）Content(FORMbinFile傳輸文件的二進(jìn)制流M文件流multipart/form-data;boundary=inputstreamfilenameZW_CZKKZCX_REQ_2015061

3、710233.json1 M文件名文件命名規(guī)范，詳見2.5Response：請(qǐng)求header屬性值（示例）必填備注ResponseHeadersbinfile-md5響應(yīng)義件一進(jìn)制流的MD5摘要，示例：bcf7837571fab538772f65b137b71b9dM文件 md5摘要，附于數(shù)據(jù)完 整性校驗(yàn)Content-Disp ositionattachment;filename=ZW_CZKKZCX_RES_2015061710233.json1 M與HllP協(xié)議規(guī)定相同，filename=返回的文件名文件命名規(guī)范，詳見 2.5Content-Enco dinggzipO與HTT的議規(guī)定相

4、同Content-Leng thM數(shù)據(jù)長(zhǎng)度Content-Length:492HIIP響應(yīng)狀態(tài)0 999M響應(yīng)碼，詳見2.4Content1 .請(qǐng)求成功時(shí)為返回文件的二進(jìn)制流。2 .當(dāng)狀態(tài)碼=700時(shí)返回錯(cuò)誤信息字符串M文件流或者UTF-8編碼的字 符串1.4. 響應(yīng)碼定義(Response Headers Status Code)響應(yīng)碼描述HIIP自定義返回碼（W 600）:200（成功） 服務(wù)器已成功處理了請(qǐng)求。201（已創(chuàng)建）請(qǐng)求成功并且服務(wù)器創(chuàng)建了新的資源。202（已接受） 服務(wù)器已接殳請(qǐng)求，但尚未處理。（非授權(quán)信息）服務(wù)器已成功處理了請(qǐng)求，但返回的信息可能來自另203一來源。204（

5、無內(nèi)容） 服務(wù)器成功處理了請(qǐng)求，但沒有返回任何內(nèi)容。205（重置內(nèi)容）服務(wù)器成功處理了請(qǐng)求，但沒有返回任何內(nèi)容。206（部分內(nèi)容）服務(wù)器成功處理了部分 GET請(qǐng)求。300（多種選擇）針對(duì)請(qǐng)求，服務(wù)器可執(zhí)行多種操作。301（永久移動(dòng)）請(qǐng)求的網(wǎng)貝已永久移動(dòng)到新位置。（臨時(shí)移動(dòng)） 服務(wù)器目前從不向位置的網(wǎng)頁(yè)響應(yīng)請(qǐng)求，但請(qǐng)求者應(yīng)繼302續(xù)使用原有位置來進(jìn)行以后的請(qǐng)求。（查看具他位置）請(qǐng)求者應(yīng)當(dāng)對(duì)不向的位置使用單獨(dú)的GET請(qǐng)求來303檢索響應(yīng)時(shí)，服務(wù)器返回此代碼。（未修改） 自從上次請(qǐng)求后， 請(qǐng)求的網(wǎng)頁(yè)未修改過。 服務(wù)器返回此響304應(yīng)時(shí)，/、會(huì)返回網(wǎng)頁(yè)內(nèi)容。（使用代理） 請(qǐng)求者只能使用代理訪問請(qǐng)求的網(wǎng)

6、頁(yè)。如果服務(wù)器返回305此響應(yīng)，還表示請(qǐng)求者應(yīng)使用代理。（臨時(shí)重定向） 服務(wù)器目前從不向位置的網(wǎng)頁(yè)響應(yīng)請(qǐng)求，但請(qǐng)求者應(yīng)307繼續(xù)使用原有位置來進(jìn)行以后的請(qǐng)求。400（錯(cuò)誤請(qǐng)求）服務(wù)器不理解請(qǐng)求的語法。401（未授權(quán)）請(qǐng)求要求身份驗(yàn)證。403（禁止） 服務(wù)器拒絕請(qǐng)求。404（未找到）服務(wù)器找不到請(qǐng)求的網(wǎng)頁(yè)。405（方法禁用） 禁用請(qǐng)求中指定的方法。406（不接受）無法使用請(qǐng)求的內(nèi)容特性響應(yīng)請(qǐng)求的網(wǎng)頁(yè)。（需要代理授權(quán)）此狀態(tài)代碼與401 （未授權(quán)）類似，但指定請(qǐng)求者407應(yīng)當(dāng)授權(quán)使用代。408（請(qǐng)求超時(shí)）服務(wù)器等候請(qǐng)求時(shí)發(fā)生超時(shí)。409（沖突）服務(wù)器在完成請(qǐng)求時(shí)發(fā)生沖突。410（已刪除） 如果請(qǐng)求

7、的資源已永久刪除，服務(wù)器就會(huì)返回此響應(yīng)。411（需要有效長(zhǎng)度）服務(wù)器不接受不含有效內(nèi)容長(zhǎng)度標(biāo)頭字段的請(qǐng)求。（未滿足前提條件）服務(wù)器未滿足請(qǐng)求者在請(qǐng)求中設(shè)置的其中一個(gè)前412提條件。（請(qǐng)求實(shí)體過大） 服務(wù)器無法處理請(qǐng)求， 因?yàn)檎?qǐng)求實(shí)體過大， 超出服413務(wù)器的處理能力。（請(qǐng)求的URI過長(zhǎng)）請(qǐng)求的URI （通常為網(wǎng)址）過長(zhǎng)，服務(wù)器無法414處理。415（不支持的媒體類型）請(qǐng)求的格式不殳請(qǐng)求頁(yè)面的支持。（請(qǐng)求范圍不符合要求）如果頁(yè)面無法提供請(qǐng)求的范圍，則服務(wù)器會(huì)416返回此狀態(tài)代碼。417（未滿足期望值）服務(wù)器未滿足”期望”請(qǐng)求標(biāo)頭字段的要求。500（服務(wù)器內(nèi)部錯(cuò)誤）服務(wù)器遇到錯(cuò)誤，無法完成請(qǐng)求。5

8、01（尚未實(shí)施）服務(wù)器不具備完成請(qǐng)求的功能。502（錯(cuò)誤網(wǎng)關(guān)） 服務(wù)器作為網(wǎng)關(guān)或代理，從上游服務(wù)器收到無效響應(yīng)。503（服務(wù)不可用） 服務(wù)器目前無法使用（由于超載或停機(jī)維護(hù)）。504（網(wǎng)關(guān)超時(shí)） 服務(wù)器作為網(wǎng)關(guān)或代理， 但是沒有及時(shí)從上游服務(wù)器收 到請(qǐng)求。505（HIIP版本不受支持） 服務(wù)器不支持請(qǐng)求中所用的HIIP協(xié)議版本。系統(tǒng)服務(wù)返回碼（錯(cuò)誤碼）（700949）:具體接口的錯(cuò)誤碼945不支持此類文件946晌應(yīng)義件不存在947請(qǐng)求數(shù)據(jù)格式錯(cuò)誤948請(qǐng)求文件名格式小止確949協(xié)議中未定義此類文件名系統(tǒng)服務(wù)預(yù)留返回碼（950999）950鑒權(quán)失敗951文件md5校驗(yàn)失敗952格式校驗(yàn)失敗953

9、請(qǐng)求文件為空999未知錯(cuò)誤1.5. 文件命名規(guī)范文件名使用" 二進(jìn)行分割，后綴為“ .json ”或者“ .gz”，當(dāng)后綴為 “.gz”時(shí)，表 示是將json文件進(jìn)行了 gzip壓縮。文件名長(zhǎng)度不超過100字節(jié)。文件命名規(guī)范：接口類型（標(biāo)識(shí)唯一）命令請(qǐng)求或響應(yīng)標(biāo)識(shí)（REQ或RES）_._時(shí)間.json 。命令請(qǐng)求標(biāo)識(shí)時(shí)間后綴REQ|RESyyyyMMddHHmmssSSS .json|.gzyyyyMMddHHmmssSSS .json|.gzREQ|RESyyyyMMddHHmmssSSS .json|.gz1.6. 數(shù)據(jù)格式及規(guī)范UTF-8編碼格式的JSONt本，數(shù)據(jù)描述規(guī)范如下

10、:縮寫定義說明M必填O可選根據(jù)實(shí)際情況填寫2 .接口定義2.1. 接口地址測(cè)試地址：https:/ 4:1128api/app/common/binapi正式地址：2.2. 核驗(yàn)駕駛員證的接口請(qǐng)求文件名示例：LICENCE_RZHY_REQ_20180707161021295.json字段描述數(shù)據(jù)類型約束說明idCode證件號(hào)碼varchar(32)是name駕駛員名稱varchar(32)否響應(yīng)文件名示例：LICENCE_RZHY_RES_20180707161021295.json字段描述數(shù)據(jù)類型約束說明result成功標(biāo)識(shí)number是0/1errorMsg失敗原因varchar(512)status駕駛員狀態(tài)varchar(32)1:無證2:申請(qǐng)審核通過3:預(yù)約考試4:獲得證書（有效）5:獲得證書（無效）2.3. 核驗(yàn)車輛運(yùn)輸證的接口請(qǐng)求文件名示例：LICENCE_CZHY_REQ_20180707161021295.json字段描述數(shù)據(jù)類型約束說明licenceCode車牌號(hào)（去掉粵）varchar(128)是B1