駕駛證三要素信息認(rèn)證接口規(guī)范文檔

1、駕駛證三要素信息認(rèn)證接入規(guī)范駕駛證三要素信息認(rèn)證接入規(guī)范 華付數(shù)據(jù)鑒權(quán)數(shù)據(jù)中心 文檔信息 文檔版本號(hào)文檔版本號(hào) V1.0 起草人起草人起草日期起草日期 2016/08/26 審核人審核人審核日期審核日期 2016/08/28 批準(zhǔn)人審核日期審核日期 2016/09/06 修訂記錄 版本版本日期日期作者作者說(shuō)明說(shuō)明 V1.02016/08/262016/08/26 初稿 V1.02016/08/282016/08/28 定稿 本文檔中的所有內(nèi)容為鑒權(quán)數(shù)據(jù)中心的機(jī)密和專屬所有。未經(jīng)鑒權(quán)數(shù)據(jù)中心的明確書面許 可，任何組織或個(gè)人不得以任何目的、任何形式及任何手段復(fù)制或傳播本文檔部分或全部 內(nèi)容。 目錄

2、目錄 1概述概述 .4 2接口介紹接口介紹 .4 2.1 通訊協(xié)議.4 2.2 安全協(xié)議.4 2.2.1 加解密.4 2.2.2 簽名方式.4 2.3 接入規(guī)則.5 2.3.1 IP 綁定.5 2.3.2 使用范圍.5 2.3.3 字符編碼.5 3駕駛證三要素信息認(rèn)證接口駕駛證三要素信息認(rèn)證接口 .5 3.1 請(qǐng)求接口地址（POST）.5 3.2 請(qǐng)求接口.5 3.3 接口返回.7 3.4 錯(cuò)誤代碼定義.9 1概述概述 駕駛證三要素信息認(rèn)證數(shù)據(jù)接口規(guī)范文檔主要用于制定標(biāo)準(zhǔn)的接口接入準(zhǔn)則及流程，指導(dǎo) 用戶開發(fā)人員及測(cè)試等相關(guān)技術(shù)人員快速了解鑒權(quán)數(shù)據(jù)中心提供的數(shù)據(jù)接口方式和相關(guān)規(guī)范， 并且方便快捷

3、的實(shí)現(xiàn)接口對(duì)接。 2接口介紹接口介紹 2.1 通訊協(xié)議通訊協(xié)議 鑒權(quán)數(shù)據(jù)中心對(duì)外數(shù)據(jù)接口主要以 http 協(xié)議發(fā)布 2.2 安全協(xié)議安全協(xié)議 2.2.1 加解密加解密 鑒權(quán)數(shù)據(jù)中心接口根據(jù)主流加解密方法定義了標(biāo)準(zhǔn)統(tǒng)一的加解密方式，DESede 進(jìn)行加解 密，即：鑒權(quán)數(shù)據(jù)中心針對(duì)用戶申請(qǐng)的接口分配唯一的接入秘鑰，用戶通過(guò)所分配的秘鑰及任 意隨機(jī)的 8 位偏移量進(jìn)行數(shù)據(jù)加密。 String data = allJson.toString(); System.out.println(請(qǐng)求報(bào)文：+data); /平臺(tái)分配的唯一的接入秘鑰 String privateKey = l4mdofLTvHky

4、ONpdlyXBiaTv; String vector = ; /隨機(jī)8位偏移量 String encrData = Cipher3DES.encrypt(data, privateKey, vector); System.out.println(加密報(bào)文：+encrData); 2.2.2 簽名方式簽名方式 接入方對(duì)自己加密完成的請(qǐng)求報(bào)文字符串進(jìn)行簽名（注意：是加密后再簽名） ，鑒權(quán)數(shù)據(jù) 中心提供統(tǒng)一的 RSA 簽名方式，即：用戶可在平臺(tái)在線生成或者自行生成簽名密鑰對(duì)，同時(shí)將 簽名公鑰上傳至平臺(tái)，私鑰留下自己注意保密，通過(guò)生成的簽名私鑰進(jìn)行簽名，產(chǎn)生簽名值。 通過(guò)平臺(tái)簽名公鑰和平臺(tái)返回簽名值

5、進(jìn)行驗(yàn)簽。 /根據(jù)用戶自己的簽名私鑰對(duì)加密報(bào)文進(jìn)行簽名 String signature=RsaSignCoder.sign(encrData, signPrivateKey); System.out.println(簽名值：+signature); /根據(jù)平臺(tái)簽名公鑰對(duì)平臺(tái)返回的加密報(bào)文進(jìn)行驗(yàn)證簽名 boolean isTrue=RsaSignCoder.verify(datas, signPublicKey, sign); 注：具體請(qǐng)參考示例代碼 2.3 接入規(guī)則接入規(guī)則 2.3.1 IPIP 綁定綁定 用戶在進(jìn)行接入的時(shí)候需要向鑒權(quán)數(shù)據(jù)中心提供接入服務(wù)器的一個(gè)或多個(gè)公網(wǎng) IP。 2.3.

6、2 使用范圍使用范圍 鑒權(quán)數(shù)據(jù)中心對(duì)于敏感數(shù)據(jù)接口，每次請(qǐng)求需要說(shuō)明查詢?cè)蜃鳛橹行牧舸?，用戶必?與鑒權(quán)數(shù)據(jù)中心簽署數(shù)據(jù)使用相關(guān)責(zé)任協(xié)議。鑒權(quán)數(shù)據(jù)中心會(huì)為每一個(gè)接入用戶分配唯一的用 戶編號(hào)，用戶可使用同一個(gè)用戶編號(hào)申請(qǐng)多個(gè)數(shù)據(jù)接口，但每個(gè)接口分別生成不同的密鑰進(jìn)行 加解密及簽名。 注：鑒權(quán)數(shù)據(jù)中心針對(duì)一個(gè)用戶多接口只提供多個(gè)加密秘鑰，一個(gè)簽名公鑰，本地簽名密鑰對(duì) 用戶自己生成。 2.3.3 字符編碼字符編碼 鑒權(quán)數(shù)據(jù)中心接口接收和返回統(tǒng)一以 UTF-8 字符集編碼格式進(jìn)行接收返回 3駕駛證三要素信息認(rèn)證接口駕駛證三要素信息認(rèn)證接口 3.1 請(qǐng)求接口地址（請(qǐng)求接口地址（POSTPOST） 3.

7、2 請(qǐng)求接口請(qǐng)求接口 接受參數(shù)： 參數(shù)名稱參數(shù)名稱參數(shù)說(shuō)明參數(shù)說(shuō)明 condition 請(qǐng)求條件的加密報(bào)文 userCode 平臺(tái)分配的用戶編號(hào) signature 加密請(qǐng)求報(bào)文的簽名值 vector 加密偏移量，用戶隨機(jī)生成 8 位隨機(jī)數(shù)字或字母 條件字段說(shuō)明： 字段名稱字段名稱注釋說(shuō)明注釋說(shuō)明請(qǐng)求說(shuō)明請(qǐng)求說(shuō)明 qryBatchNo 查詢批次號(hào)唯一，不超過(guò) 20 位 userCode 商戶編號(hào)平臺(tái)分配的商戶編號(hào) sysCode 應(yīng)用編號(hào)平臺(tái)創(chuàng)建應(yīng)用分配的唯一編號(hào) qryReason 查詢?cè)蚝?jiǎn)單說(shuō)明調(diào)用原由，可為空 qryDate 查詢?nèi)掌诟袷剑簓yyyMMdd，可為空 qryTime 查詢

8、時(shí)間格式：hhmmss，可為空 realName 姓名不超過(guò) 20 位，可為空 driverLicenseNumbe 駕駛證號(hào)碼駕駛證號(hào)碼，不可為空 fileNumber 檔案編號(hào)駕駛證檔案編號(hào)，可為空 quasiDrivingType 準(zhǔn)駕類型駕駛證類型，可為空 issueDate 初次領(lǐng)證日期可為空 birthDate 出身日期可為空 termValidityStart 有效期始可為空 termValidityEnd 有效期止可為空 注：駕駛證必選，其余任選二個(gè)。 請(qǐng)求條件報(bào)文格式： header: qryBatchNo: , userCode: TEST10001, sysCode: T

9、ESTAPP10001, qryReason: 信貸, qryDate: , qryTime: , condition: realName: 張三, driverLicenseNumber: *, quasiDrivingType: C2, issueDate: , fileNumber: , termValidityStart: , termValidityEnd: , birthDate: , 3.3 接口返回接口返回 返回參數(shù)： 參數(shù)名稱參數(shù)名稱參數(shù)說(shuō)明參數(shù)說(shuō)明 contents 返回?cái)?shù)據(jù)的加密報(bào)文 signature 加密請(qǐng)求報(bào)文的簽名值 正確返回字段說(shuō)明： 字段名稱字段名稱字段說(shuō)明字

10、段說(shuō)明 header 報(bào)文頭 name 返回?cái)?shù)據(jù)的名稱 recordNum 返回?cái)?shù)據(jù)的數(shù)量 realName 姓名 driverLicenseNumbe 駕駛證號(hào)碼 fileNumber 檔案編號(hào) quasiDrivingType 準(zhǔn)駕類型 issueDate 初次領(lǐng)證日期 birthDate 出身日期 termValidityStart 有效期始 termValidityEnd 有效期止 quasiDrivingType 參數(shù)的認(rèn)證結(jié)果（0：認(rèn)證未通過(guò)、1：認(rèn)證通過(guò)、- 1：當(dāng)車牌號(hào)碼不存在，某一個(gè)為 0，其它為1） 正確返回報(bào)文格式： data: name: 駕駛證三要素信息認(rèn)證, rec

11、ordNum: 1, record: realName: 張三, realNameCode: 1, driverLicenseNumber: *, driverLicenseNumberCode: 1, quasiDrivingType: C2, quasiDrivingTypeCode: 0, issueDate: , issueDateCode: 1, fileNumber: , fileNumberCode: 0, termValidityStart: , termValidityStartCode: 0, termValidityEnd: , termValidityEndCode: 0, birthDate: , birthDateCode: 0 錯(cuò)誤返回字段說(shuō)明： 字段名稱字段名稱字段說(shuō)明字段說(shuō)明 code 錯(cuò)誤代碼 codeDesc 錯(cuò)誤代碼描述 錯(cuò)誤返回報(bào)文格式： msg: codeDesc: 姓名校驗(yàn)不通過(guò), code: 01 3.4 錯(cuò)誤代碼定義錯(cuò)誤代碼定義 錯(cuò)誤代碼錯(cuò)誤代碼代碼描述說(shuō)明代碼描述說(shuō)明 01 姓名校驗(yàn)不通過(guò) 02 身份證號(hào)碼有誤 05 數(shù)據(jù)校驗(yàn)不通過(guò) 09 駕駛證號(hào)校驗(yàn)不通過(guò) 10 請(qǐng)求條件有缺失，請(qǐng)確認(rèn)是否遺漏！ 20 您的體驗(yàn)次數(shù)已使用完，請(qǐng)完成正式簽約！ 30 您的簽約次數(shù)已使