遼寧省新能源汽車監(jiān)管平臺(tái)與車輛企業(yè)平臺(tái)數(shù)據(jù)對(duì)接說(shuō)明書_第1頁(yè)
遼寧省新能源汽車監(jiān)管平臺(tái)與車輛企業(yè)平臺(tái)數(shù)據(jù)對(duì)接說(shuō)明書_第2頁(yè)
遼寧省新能源汽車監(jiān)管平臺(tái)與車輛企業(yè)平臺(tái)數(shù)據(jù)對(duì)接說(shuō)明書_第3頁(yè)
遼寧省新能源汽車監(jiān)管平臺(tái)與車輛企業(yè)平臺(tái)數(shù)據(jù)對(duì)接說(shuō)明書_第4頁(yè)
遼寧省新能源汽車監(jiān)管平臺(tái)與車輛企業(yè)平臺(tái)數(shù)據(jù)對(duì)接說(shuō)明書_第5頁(yè)
已閱讀5頁(yè),還剩27頁(yè)未讀, 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(quán)說(shuō)明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請(qǐng)進(jìn)行舉報(bào)或認(rèn)領(lǐng)

文檔簡(jiǎn)介

遼寧省新能源汽車監(jiān)管平臺(tái)與車輛企業(yè)平臺(tái)數(shù)據(jù)對(duì)接說(shuō)明書文檔修改控制序號(hào)版本內(nèi)容描述日期作者11新建2020/07/28李亞敏目錄目錄 iii一、 概述 11.1 對(duì)接地址 11.2 企業(yè)對(duì)接流程 11.3 車輛數(shù)據(jù)上傳標(biāo)準(zhǔn) 31.3.1 車輛靜態(tài)數(shù)據(jù) 31.3.2 車輛電池?cái)?shù)據(jù) 31.3.3 車輛實(shí)時(shí)數(shù)據(jù) 31.3.4 接口分類 3二、 企業(yè)注冊(cè)流程 4三、 企業(yè)平臺(tái)聯(lián)調(diào)流程 53.1車型注冊(cè) 83.2車輛數(shù)據(jù)測(cè)試 83.3實(shí)時(shí)信息測(cè)試 8四、 車型聯(lián)調(diào)流程 144.1車型注冊(cè) 154.2車型聯(lián)調(diào) 16五、 車輛靜態(tài)數(shù)據(jù)接口 195.1header請(qǐng)求參數(shù) 195.2body請(qǐng)求參數(shù) 195.3響應(yīng)參數(shù) 225.4狀態(tài)碼對(duì)應(yīng)表 225.5加密方式 235.5.1公鑰 235.5.2加密及簽名規(guī)則 235.6示例 23六、 車輛電池?cái)?shù)據(jù)接口 246.1header請(qǐng)求參數(shù) 256.2body請(qǐng)求參數(shù) 256.3示例 266.3.1數(shù)據(jù)結(jié)構(gòu) 26概述新能源汽車公共數(shù)據(jù)平臺(tái)系統(tǒng)是通過(guò),車企平臺(tái)將車輛數(shù)據(jù)上傳到平臺(tái),以達(dá)到監(jiān)管新能源汽車行駛和充電行為,并建立相關(guān)大數(shù)據(jù)平臺(tái)的目的。企業(yè)將數(shù)據(jù)對(duì)接到新能源汽車公共數(shù)據(jù)平臺(tái),需要遵循一定的流程和標(biāo)準(zhǔn)。流程包括:企業(yè)注冊(cè)流程、平臺(tái)聯(lián)調(diào)流程、車型接入流程。標(biāo)準(zhǔn)包括:車輛靜態(tài)數(shù)據(jù)接口標(biāo)準(zhǔn)、車輛電池?cái)?shù)據(jù)接口標(biāo)準(zhǔn)和國(guó)標(biāo)《GBT32960.3-2016標(biāo)準(zhǔn)》。對(duì)接地址

平臺(tái)聯(lián)調(diào)測(cè)試環(huán)境對(duì)接地址::8101平臺(tái)正式生產(chǎn)環(huán)境對(duì)接地址::32333企業(yè)對(duì)接流程車企對(duì)接平臺(tái)須首先進(jìn)行企業(yè)注冊(cè)和一次平臺(tái)聯(lián)調(diào)。企業(yè)每接入一種新車型之前,必須進(jìn)行車型接入測(cè)試??偭鞒倘缦拢很囕v數(shù)據(jù)上傳標(biāo)準(zhǔn)企業(yè)上傳的車輛數(shù)據(jù)包含3種類型:車輛靜態(tài)數(shù)據(jù)、車輛電池?cái)?shù)據(jù)和車輛實(shí)時(shí)數(shù)據(jù)。車輛靜態(tài)數(shù)據(jù)車輛靜態(tài)數(shù)據(jù)即車輛vin號(hào)、車輛型號(hào)、iccid號(hào)、車牌號(hào)等車輛靜態(tài)信息,只需上傳一次。具體流程見(jiàn)下文車輛靜態(tài)數(shù)據(jù)上傳接口。車輛電池?cái)?shù)據(jù)車輛電池?cái)?shù)據(jù)即車輛電池編碼、電芯編碼、電池包生產(chǎn)企業(yè)、電池包額定電壓等電池相關(guān)信息,只需上傳一次。具體流程見(jiàn)下文車輛電池?cái)?shù)據(jù)上傳接口。車輛實(shí)時(shí)數(shù)據(jù)車輛的實(shí)時(shí)數(shù)據(jù):即國(guó)標(biāo)《GB/T32960.3-2016》,中所定義的實(shí)時(shí)信息上報(bào)數(shù)據(jù)。包括:整車數(shù)據(jù)、驅(qū)動(dòng)電機(jī)數(shù)據(jù)、燃料電池?cái)?shù)據(jù)、發(fā)動(dòng)機(jī)數(shù)據(jù)、車輛位置數(shù)據(jù)、極值數(shù)據(jù)、報(bào)警數(shù)據(jù),等七大部分。接口分類車輛靜態(tài)數(shù)據(jù)和電池?cái)?shù)據(jù)的接口采用RESTfulAPI方式定義接口,采用RSA加密算法,對(duì)數(shù)據(jù)進(jìn)行加密。通過(guò)數(shù)據(jù)簽名保證數(shù)據(jù)的完整性。車輛實(shí)時(shí)數(shù)據(jù)采用TCP方式,按照國(guó)標(biāo)《GB/T32960.3-2016》標(biāo)準(zhǔn)所定義的通訊協(xié)議和數(shù)據(jù)格式,上傳實(shí)時(shí)數(shù)據(jù)到監(jiān)控平臺(tái)。企業(yè)注冊(cè)流程車企在使用監(jiān)控平臺(tái)前,需要先注冊(cè)用戶,再完成企業(yè)資料的申請(qǐng)審核流程,才可以正式登陸監(jiān)控平臺(tái)。企業(yè)注冊(cè)流程分為以下幾個(gè)步驟:使用瀏覽器打開(kāi)監(jiān)控平臺(tái)網(wǎng)站,網(wǎng)址:填寫用戶注冊(cè)信息填寫企業(yè)資料信息填寫車企平臺(tái)運(yùn)營(yíng)商信息車企提交信息等待審核如審核失敗需要重新填寫相關(guān)信息,并提交再次審核審核通過(guò)后,企業(yè)需線下和監(jiān)控平臺(tái)簽署協(xié)議。協(xié)議簽署完成后,企業(yè)平臺(tái)完成整個(gè)注冊(cè)流程企業(yè)在監(jiān)控平臺(tái)注冊(cè)信息審核通過(guò)后,會(huì)收到監(jiān)控平臺(tái)發(fā)送的動(dòng)態(tài)數(shù)據(jù)接入的平臺(tái)登錄用戶名及密碼的郵件流程圖如下:企業(yè)平臺(tái)聯(lián)調(diào)流程企業(yè)注冊(cè)成功,首先必須申請(qǐng)進(jìn)行平臺(tái)聯(lián)調(diào)。平臺(tái)聯(lián)調(diào)是為了驗(yàn)證企業(yè)平臺(tái),是否正確理解了監(jiān)控平臺(tái)的接入要求,是否滿足國(guó)標(biāo)《GBT32960.3-2016》的技術(shù)要求,是否具備基本的平臺(tái)對(duì)接能力。每個(gè)企業(yè)必須首先通過(guò)平臺(tái)聯(lián)調(diào),才可以開(kāi)展后續(xù)接入真實(shí)車輛的工作。平臺(tái)聯(lián)調(diào)只須完成一次。平臺(tái)聯(lián)調(diào)分為三個(gè)子流程:車型注冊(cè)審核、車輛數(shù)據(jù)測(cè)試、實(shí)時(shí)信息測(cè)試。平臺(tái)聯(lián)調(diào)流程如下:3.1車型注冊(cè)車企預(yù)約平臺(tái)過(guò)檢后,監(jiān)控平臺(tái)會(huì)自動(dòng)生成測(cè)試車型,在此階段企業(yè)只需填入虛擬的車型信息,不要求真實(shí)。車企車型注冊(cè)字段定義。填寫完成后提交管理平臺(tái)審核。平臺(tái)審核通過(guò)后,進(jìn)入車輛數(shù)據(jù)測(cè)試步驟。平臺(tái)審核失敗后,需要重新開(kāi)始新的平臺(tái)聯(lián)調(diào)申請(qǐng)。3.2車輛數(shù)據(jù)測(cè)試 在此階段企業(yè)調(diào)用上傳車輛數(shù)據(jù)的接口,將車輛的靜態(tài)數(shù)據(jù)上傳到平臺(tái)上。需要上傳車輛的數(shù)據(jù)。上傳成功后,線下通知管理平臺(tái)人員進(jìn)行審核。平臺(tái)審核通過(guò)后,進(jìn)入平臺(tái)測(cè)試步驟。平臺(tái)審核失敗后,需要重新開(kāi)始新的平臺(tái)聯(lián)調(diào)申請(qǐng)。3.3實(shí)時(shí)信息測(cè)試3.3.1實(shí)時(shí)信息測(cè)試說(shuō)明 實(shí)時(shí)信息測(cè)試的目的,是模擬真實(shí)情況下企業(yè)向平臺(tái)發(fā)送的消息是否符合要求。實(shí)時(shí)信息測(cè)試項(xiàng)目包括:平臺(tái)登錄登出驗(yàn)證企業(yè)平臺(tái)發(fā)送登錄報(bào)文,成功在監(jiān)控平臺(tái)完成登入操作企業(yè)平臺(tái)發(fā)送登出報(bào)文,在監(jiān)控平臺(tái)完成登出操作多次登入時(shí),流水號(hào)遞增同一次登錄登出流水號(hào)一致車輛登錄登出驗(yàn)證轉(zhuǎn)發(fā)車輛登錄登出報(bào)文多次登入時(shí),流水號(hào)遞增同一次登錄登出流水號(hào)一致車輛登錄流水號(hào)每天清零車輛行駛數(shù)據(jù)驗(yàn)證轉(zhuǎn)發(fā)車輛行駛狀態(tài)下實(shí)時(shí)數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)不應(yīng)出現(xiàn)違反國(guó)家標(biāo)準(zhǔn)或超出合理范圍的數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)要符合實(shí)車數(shù)據(jù)狀態(tài)監(jiān)控平臺(tái)與企業(yè)進(jìn)行數(shù)據(jù)核對(duì)車輛充電數(shù)據(jù)驗(yàn)證轉(zhuǎn)發(fā)車輛充電狀態(tài)下實(shí)時(shí)數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)不應(yīng)出現(xiàn)違反國(guó)家標(biāo)準(zhǔn)或超出合理范圍的數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)要符合實(shí)車數(shù)據(jù)狀態(tài)監(jiān)控平臺(tái)與企業(yè)進(jìn)行數(shù)據(jù)核對(duì)車輛滿電數(shù)據(jù)驗(yàn)證轉(zhuǎn)發(fā)車輛soc100%狀態(tài)下實(shí)時(shí)數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)不應(yīng)出現(xiàn)違反國(guó)家標(biāo)準(zhǔn)或超出合理范圍的數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)要符合實(shí)車數(shù)據(jù)狀態(tài)監(jiān)控平臺(tái)與企業(yè)進(jìn)行數(shù)據(jù)核對(duì)車輛報(bào)警數(shù)據(jù)驗(yàn)證觸發(fā)車輛報(bào)警,并轉(zhuǎn)發(fā)車輛報(bào)警狀態(tài)下實(shí)時(shí)數(shù)據(jù)需測(cè)試國(guó)標(biāo)19項(xiàng)報(bào)警報(bào)警數(shù)據(jù)滿足前后30s數(shù)據(jù)1秒1條上報(bào)監(jiān)控平臺(tái)與企業(yè)進(jìn)行數(shù)據(jù)核對(duì)車輛補(bǔ)發(fā)數(shù)據(jù)驗(yàn)證轉(zhuǎn)發(fā)車輛補(bǔ)發(fā)數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)不應(yīng)出現(xiàn)違反國(guó)家標(biāo)準(zhǔn)或超出合理范圍的數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)要符合實(shí)車數(shù)據(jù)狀態(tài)監(jiān)控平臺(tái)與企業(yè)進(jìn)行數(shù)據(jù)核對(duì)平臺(tái)補(bǔ)發(fā)數(shù)據(jù)驗(yàn)證使企業(yè)平臺(tái)與監(jiān)控平臺(tái)斷開(kāi)鏈接,恢復(fù)鏈接后平臺(tái)補(bǔ)發(fā)車輛實(shí)時(shí)數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)不應(yīng)出現(xiàn)違反國(guó)家標(biāo)準(zhǔn)或超出合理范圍的數(shù)據(jù)車輛實(shí)時(shí)數(shù)據(jù)要符合實(shí)車數(shù)據(jù)狀態(tài)監(jiān)控平臺(tái)與企業(yè)進(jìn)行數(shù)據(jù)核對(duì)3.3.2實(shí)時(shí)信息測(cè)試步驟平臺(tái)實(shí)時(shí)信息測(cè)試步驟:執(zhí)行平臺(tái)登入、平臺(tái)登出操作,共計(jì)5個(gè)循環(huán)平臺(tái)登入登出之間要保持3分鐘車輛數(shù)據(jù)傳輸執(zhí)行車輛登入、車輛登出操作,共計(jì)5個(gè)循環(huán)車輛登入登出之間要保持3分鐘車輛數(shù)據(jù)傳輸發(fā)送車輛行駛數(shù)據(jù),車輛行駛數(shù)據(jù)維持發(fā)送15分鐘以上發(fā)送車輛充電數(shù)據(jù),車輛充電數(shù)據(jù)維持發(fā)送15分鐘以上發(fā)送車輛滿電數(shù)據(jù),車輛滿電數(shù)據(jù)維持發(fā)送5分鐘以上發(fā)送車輛報(bào)警數(shù)據(jù)需逐個(gè)觸發(fā)車輛19項(xiàng)報(bào)警數(shù)據(jù)每項(xiàng)報(bào)警需維持2分鐘發(fā)送車輛補(bǔ)發(fā)數(shù)據(jù),車輛補(bǔ)發(fā)數(shù)據(jù)維持發(fā)送15分鐘發(fā)送平臺(tái)補(bǔ)發(fā)數(shù)據(jù),平臺(tái)補(bǔ)發(fā)數(shù)據(jù)維持發(fā)送10分鐘填寫車輛聯(lián)調(diào)記錄表,文檔如下將車輛聯(lián)調(diào)記錄表及車企平臺(tái)日志文件以線下的方式提供到監(jiān)控平臺(tái)監(jiān)控平臺(tái)審核車企數(shù)據(jù),審核結(jié)果會(huì)以郵件方式提供給車企測(cè)試僅提供結(jié)果、錯(cuò)誤步驟,不提供錯(cuò)誤細(xì)節(jié)及技術(shù)指導(dǎo),望車企知悉檢測(cè)完成后,應(yīng)第一時(shí)間主動(dòng)提供測(cè)試記錄表及服務(wù)器日志,日志內(nèi)容應(yīng)包括服務(wù)器發(fā)送時(shí)間,報(bào)文時(shí)間,國(guó)標(biāo)報(bào)文及vin整體測(cè)試流程圖如下:車型聯(lián)調(diào)流程企業(yè)在通過(guò)平臺(tái)聯(lián)調(diào)后,即可申請(qǐng)進(jìn)行,正式車型接入的測(cè)試。車型接入測(cè)試是為了驗(yàn)證,企業(yè)接入車型的車輛上報(bào)數(shù)據(jù),是否滿足監(jiān)控平臺(tái)的要求。車型接入分為兩個(gè)子流程:車型注冊(cè)、車型聯(lián)調(diào)。車型聯(lián)調(diào)流程圖如下:4.1車型注冊(cè)在此階段企業(yè)必須填入真實(shí)的車型信息。填寫完成后提交管理平臺(tái)審核。平臺(tái)審核通過(guò)后,進(jìn)入接入測(cè)試步驟。平臺(tái)審核失敗后,需要重新開(kāi)始新的車型注冊(cè)申請(qǐng)。4.2車型聯(lián)調(diào)企業(yè)注冊(cè)車型通過(guò)審核后,即可默認(rèn)添加進(jìn)車型聯(lián)調(diào)批次。車型聯(lián)調(diào)時(shí)需準(zhǔn)備一臺(tái)實(shí)車,并將車輛靜態(tài)信息和電池信息通過(guò)接口上傳到監(jiān)控平臺(tái)。 車型聯(lián)調(diào)步驟:執(zhí)行平臺(tái)登入執(zhí)行車輛登入、車輛登出操作,共計(jì)5個(gè)循環(huán)車輛登入登出之間要保持3分鐘車輛數(shù)據(jù)傳輸發(fā)送車輛行駛數(shù)據(jù),車輛行駛數(shù)據(jù)維持發(fā)送15分鐘以上發(fā)送車輛充電數(shù)據(jù),車輛充電數(shù)據(jù)維持發(fā)送15分鐘以上發(fā)送車輛滿電數(shù)據(jù),車輛滿電數(shù)據(jù)維持發(fā)送5分鐘以上發(fā)送車輛報(bào)警數(shù)據(jù)需逐個(gè)觸發(fā)車輛19項(xiàng)報(bào)警數(shù)據(jù)每項(xiàng)報(bào)警需維持2分鐘發(fā)送車輛補(bǔ)發(fā)數(shù)據(jù),車輛補(bǔ)發(fā)數(shù)據(jù)維持發(fā)送15分鐘執(zhí)行平臺(tái)登出填寫車輛聯(lián)調(diào)記錄表,文檔如下將車輛聯(lián)調(diào)記錄表及車企平臺(tái)日志文件以線下的方式提供到監(jiān)控平臺(tái)監(jiān)控平臺(tái)審核車企數(shù)據(jù),審核結(jié)果會(huì)以郵件方式提供給車企測(cè)試僅提供結(jié)果、錯(cuò)誤步驟,不提供錯(cuò)誤細(xì)節(jié)及技術(shù)指導(dǎo),望車企知悉檢測(cè)完成后,應(yīng)第一時(shí)間主動(dòng)提供測(cè)試記錄表及服務(wù)器日志,日志內(nèi)容應(yīng)包括服務(wù)器發(fā)送時(shí)間,報(bào)文時(shí)間,國(guó)標(biāo)報(bào)文及vin車型聯(lián)調(diào)流程圖如下:車輛靜態(tài)數(shù)據(jù)接口企業(yè)平臺(tái)在上傳車輛的實(shí)時(shí)數(shù)據(jù)之前,必須將車輛相關(guān)的基本信息,通過(guò)該接口上傳到監(jiān)控平臺(tái)。規(guī)范用于指導(dǎo)車企平臺(tái)合理調(diào)用該接口上傳車輛靜態(tài)相關(guān)數(shù)據(jù)。請(qǐng)求方式:httppost接口組成:由服務(wù)URL、請(qǐng)求參數(shù)和車輛數(shù)據(jù)組成。其中請(qǐng)求參數(shù)放在http的header部分。車輛數(shù)據(jù)放在http的body部分。響應(yīng)參數(shù):json服務(wù)URL:5.1header請(qǐng)求參數(shù)參數(shù)名參數(shù)類型必須默認(rèn)值描述appKeyStringY平臺(tái)登入用戶名secretStringYRSA取值范圍:RSA(RSA加密),NA(不加密)signtlongY調(diào)用接口時(shí)間戳,精確到毫秒signStringY簽名accessTypeStringY接入類型類型,正式:1,測(cè)試:05.2body請(qǐng)求參數(shù)由車輛注冊(cè)數(shù)據(jù)字段構(gòu)成的json數(shù)組。車輛注冊(cè)數(shù)據(jù)字段說(shuō)明如下:序號(hào)屬性類型是否必填備注(取值說(shuō)明等)1vehicleRecordModelStringY車型型號(hào)(備案車型型號(hào))2vinStringY車架號(hào)(17位)3iccidStringY4vehicleUseStringY車輛用途公交客車-111801通勤客車-111802旅游客車-111803公路客車-111804公務(wù)乘用車-111805出租乘用車-111806租賃乘用車-111807私人乘用車-111808郵政特種車-111809物流特種車-111810環(huán)衛(wèi)特種車-111811工程特種車-1118125productionDatelongY車輛生產(chǎn)日期6saleDatelongY銷售日期7packCodeStringY可充電儲(chǔ)能系統(tǒng)編碼(多個(gè)逗號(hào)分隔)8packProcDatelongY動(dòng)力蓄電池生產(chǎn)日期(多個(gè)逗號(hào)分隔)9motorModelStringY驅(qū)動(dòng)電機(jī)序號(hào)(多個(gè)逗號(hào)分隔)10engineNumberStringY發(fā)動(dòng)機(jī)編號(hào)11tboxCodeStringY車載終端編號(hào)12accessDatelongY接入日期13accessTypeStringY接入類型(0:測(cè)試,1:正式)14firstOnlineDatelongY上線日期15plateNoStringY車牌號(hào)16operatingUnitStringY運(yùn)營(yíng)單位17storageLocationStringY存放地點(diǎn)18contactPersonStringY聯(lián)系人19contactNumberStringY聯(lián)系電話20companyUniqueStringY車企唯一標(biāo)識(shí)21drivingLicenseNumberStringY行駛證號(hào)22buyerCountyStringY購(gòu)車人居住地所在區(qū)縣23operationCorporateNameStringY單位法人代表24operationPhoneStringY法人代表手機(jī)25registeredPlaceStringY運(yùn)營(yíng)單位地址26actualPlaceStringY運(yùn)營(yíng)地址27chargingPileAddrStringY對(duì)應(yīng)車輛充電樁地址28tboxTypeStringY終端類型(0:tbox1:其他)29tboxCompanyStringY終端廠商30areaCodeStringY上牌區(qū)域注:一. productionDate、saleDate、packProcDate、accessDate、firstOnlineDate賦值為String型如:yyyy-MM-dd二.車企唯一標(biāo)識(shí)規(guī)則建議:車企所在城市郵編+VIN前三位+2位序號(hào)+0000005.3響應(yīng)參數(shù)參數(shù)名稱參數(shù)類型是否必填參數(shù)描述statusStringY見(jiàn)狀態(tài)碼定義表errorCodeintNerrorMessageStringN5.4狀態(tài)碼對(duì)應(yīng)表狀態(tài)碼返回信息含義200Ok服務(wù)器成功返回用戶請(qǐng)求的數(shù)據(jù)201Created新建或修改數(shù)據(jù)成功400InvalidRequest請(qǐng)求參數(shù)非法,服務(wù)器沒(méi)有進(jìn)行新建或修改數(shù)據(jù)的操作401Unauthorized用戶授權(quán)錯(cuò)誤(令牌、用戶名、密碼、簽名錯(cuò)誤)403Forbidden表示用戶得到授權(quán)(與401錯(cuò)誤相對(duì)),但是訪問(wèn)是被禁止的(未通過(guò)白名單)404NotFound發(fā)出的請(qǐng)求針對(duì)的記錄不存在,服務(wù)器沒(méi)有進(jìn)行操作406NotAcceptable用戶請(qǐng)求的格式不可得(比如用戶請(qǐng)求XML格式,但是只有JSON格式)500InternalServerError服務(wù)器發(fā)生錯(cuò)誤,客戶端將發(fā)出的請(qǐng)求沒(méi)有成功501NotImplemented服務(wù)器不支持客戶端所請(qǐng)求功能5.5加密方式采用RSA加密方式加密。5.5.1公鑰MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCQJsYPa+wqnRqLjcDAXt/YodOqAUD2ZXl/eeapQh6QUPIyL8+9iQZFAIBnQ5t3s0hQJiU9UR7Z4YNtnMb4ahwtqDsGUT7e6/dsc8vU6BR8vdwMdXbOD0JjYS+ky5UDsbYLe1DEdWl+kZZxIg0Adh61ImY92OpmOqftz0EMoaBfKwIDAQAB5.5.2加密及簽名規(guī)則1.按順序拼接輸入?yún)?shù)得到字符串A。2.對(duì)拼接的字符串A做MD5加密運(yùn)算得到字符串B。3.設(shè)置header中sign參數(shù)值為該字符串B。4.body參數(shù)加密。5.6示例為描述方便,假設(shè)有一個(gè)第三方車企:國(guó)標(biāo)協(xié)議平臺(tái)登錄用戶名為:1234567890,國(guó)標(biāo)協(xié)議平臺(tái)登錄密碼為:abcdefghijklmnopqrstuvwxyz123456調(diào)用接口API時(shí)間戳為:14878303699421、按順序拼接參數(shù)得到字符串:appKey=1234567890,secret=RSA,signt=1487830369942,secretKey=abcdefghijklmnopqrstuvwxyz1234562、對(duì)拼接的字符串做MD5加密運(yùn)算得到字符串為b8d90655abd3566a171aba7b0d7eca273、設(shè)置header中sign參數(shù)值為:b8d90655abd3566a171aba7b0d7eca274、body參數(shù)加密假定車企想注冊(cè)2輛車,得到j(luò)son串為:[{"iccid":"123456789","vin":"12356"},{"vin":"1235"}]使用公鑰將Jsonstring進(jìn)行RSA公鑰加密,再將加密結(jié)果進(jìn)行base64編碼得到加密串,將得到加密密文放到body里傳輸,后臺(tái)使用私鑰解密,加密串為:wWLth8ZuifMdY15tymlpbVEX35S+LWovKEAl3sqEIAQQD1J296EiSKDu/BIYky5BFj7RObL8IZwWcDZnwUxanFNXPgrjDCWLwZqDMqTTY5yfGZ0sxk6npJq5KOWDG6522GOoVey28bWY0pXP61Pk9p7tOCmDDgJDGNXONwHT0=車輛電池?cái)?shù)據(jù)接口規(guī)范用于指導(dǎo)車企平臺(tái)合理調(diào)用該接口上傳電池相關(guān)數(shù)據(jù)。(注:車輛靜態(tài)數(shù)據(jù)重新上傳后,需要重新上傳對(duì)應(yīng)車輛的電池?cái)?shù)據(jù)。)請(qǐng)求方式:httppost接口組成:由服務(wù)URL、請(qǐng)求參數(shù)和車輛數(shù)據(jù)組成。其中請(qǐng)求參數(shù)放在http的header部分。車輛數(shù)據(jù)放在http的body部分。響應(yīng)參數(shù):json服務(wù)URL:6.1header請(qǐng)求參數(shù)參數(shù)名參數(shù)類型必須默認(rèn)值描述If-None-MatchStringY592d6db2-219accessNameStringY平臺(tái)登入用戶名accessCodeStringY平臺(tái)登入密碼accessTypeStringY接入類型類型,正式:1,測(cè)試:0Content-TypeStringYapplication/json6.2body請(qǐng)求參數(shù)參數(shù)名參數(shù)類型必須默認(rèn)值描述batteryDataDTOListListY電池信息列表list,詳細(xì)數(shù)據(jù)均放置在list中對(duì)應(yīng)的元素中vinStringY車輛vin碼(17位)batteryTypeStringY電池類型1:磷酸鐵鋰電池/2:錳酸鋰電池/3:鈷酸鋰電池/4:三元材料電池/5:聚合物鋰離子電池/6:超級(jí)電容/7:鈦酸鋰電池/8:燃料電池/9:其他電池類型batteryCodingStandardStringY電池編碼標(biāo)準(zhǔn)1:國(guó)標(biāo)/2:企業(yè)自己的標(biāo)準(zhǔn)batteryManufacturerStringY電池包生產(chǎn)企業(yè)packVoltageStringY電池包額定電壓(V)packCapacityStringY電池包額定容量(AH)packCodeStringY電池包編碼packProcDateStringY電池包生產(chǎn)日期(yyyy-MM-dd)moduleVoltageStringY電池模組額定電壓(V)moduleCapacityStringY電池模組額定容量(AH)batteryModuleCodeStringY電池模組編碼moduleManufacturerStringY模組生產(chǎn)企業(yè)cellManufacturerStringY電芯生產(chǎn)企業(yè)cellVoltageStringY電芯額定電壓(V)cellCapacityStringY電芯額定容量(AH)cellCodeStringY電芯編碼6.3示例6.3.1數(shù)據(jù)結(jié)構(gòu)Headers:If-None-Match:592d6db2-219accessName:exa7d3a2testaccessCode:exa5bd3f7f745499testaccessType:1Content-Type:application/json{ "batteryDataDTOList":[{ "vin":"LLLLLLLLLLLLLLL", "batteryType":"1", "batteryCodingStandard":"1", "batteryManufacturer":"XXXX電池包生產(chǎn)有限公司", "packVoltage":"2", "packCapacity":"1", "packCode":"XXC00X1", "packProcDate":"2017-07-26", "batteryModuleDataList":[{ "moduleVoltage":"12", "moduleCapacity":"10", "moduleCode":"XXC001", "moduleManufacturer":"xxxx電池模組生產(chǎn)有限公司", "batteryCellDataList":[{ "cellManufacturer":"XXX電芯生產(chǎn)企業(yè)", "cellVoltage":"12.1", "cellCapacity":"10.2", "cellCode":"XXXABC1" },{ "cellManufacturer":"XXX電芯生產(chǎn)企業(yè)", "cellVoltage":"12.1", "cellCapacity":"10.2", "cellCode":"XXXABC1" }] },{ "moduleVoltage":"12", "moduleCapacity":"10", "moduleCode":"XXC001", "moduleManufacturer":"xxxx電池模組生產(chǎn)有限公司", "batteryCellDataList":[{ "cellManufacturer":"XXX電芯生產(chǎn)企業(yè)", "cellVoltage":"12.1", "cellCapacity":"10.2", "cellCode":"XXXABC1" },{ "cellManufacturer":"XXX電芯生產(chǎn)企業(yè)", "cellVoltage":"12.1", "cellCapacity":"10.2", "cellCode":"XXXABC1" }] }] },{ "vin":"LLLLLLLLLLLLLLL", "batteryType":"1", "batteryCodingStandard":"1", "batteryManufacturer":"XXXX電池包生產(chǎn)有限公司", "packVoltage":"2", "packCapacity":"1", "packCode":"XXC00X1", "packProcDate":"2017-07-26", "batteryModuleDataList":[{ "moduleVoltage":"12", "moduleCapacity":"10", "moduleCode":"XXC001", "moduleManufact

溫馨提示

  • 1. 本站所有資源如無(wú)特殊說(shuō)明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請(qǐng)下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請(qǐng)聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁(yè)內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒(méi)有圖紙預(yù)覽就沒(méi)有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫(kù)網(wǎng)僅提供信息存儲(chǔ)空間,僅對(duì)用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對(duì)用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對(duì)任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請(qǐng)與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶因使用這些下載資源對(duì)自己和他人造成任何形式的傷害或損失。

最新文檔

評(píng)論

0/150

提交評(píng)論