Ptaxi網(wǎng)約車牌照代辦整理貴州省網(wǎng)約車監(jiān)管平臺數(shù)據(jù)對接說明
2022-11-17 11:37:30 行業(yè)資訊Ptaxi網(wǎng)約車牌照代辦公司整理貴州省網(wǎng)約車監(jiān)管平臺數(shù)據(jù)對接說明,跟著小編一起來看看吧!
一、數(shù)據(jù)對接流程
以下步驟請按先后順序完成:
1、申請貴州省網(wǎng)約車監(jiān)管平臺測試環(huán)境數(shù)據(jù)對接賬號:
申請賬號需提供以下信息:
a、公司全稱;
b、在貴州那些市州有業(yè)務(wù);
c、公司有多少車;
d、如果已在交通部備案,請?zhí)峁┎坷锝o你們分配的CompanyId;
e、你方技術(shù)對接人的姓名及電話。
2、參照《網(wǎng)絡(luò)預(yù)約出租汽車監(jiān)管信息交互平臺總體技術(shù)要求(貴州改)》文件制定的標(biāo)準(zhǔn)進(jìn)行數(shù)據(jù)對接,平臺測試環(huán)境數(shù)據(jù)接收測試環(huán)境地址為:http://czc.tyxxtb.com/。如果調(diào)用相關(guān)數(shù)據(jù)對接接口返回200或ok則表示數(shù)據(jù)傳輸成功。
3、數(shù)據(jù)傳輸成功,不代表數(shù)據(jù)能夠正確入庫,有數(shù)據(jù)格式錯(cuò)誤導(dǎo)致可能不能入庫的情況,所以在傳輸成功后,等待幾秒到幾分鐘的時(shí)間,可以在貴州省網(wǎng)約車監(jiān)管平臺測試環(huán)境中通過“傳輸日志”功能查看數(shù)據(jù)是否入庫成功,入庫數(shù)量是否和原始報(bào)文相符。
如果入庫處理出現(xiàn)異常,請點(diǎn)擊進(jìn)去查看異常原因,并針對提示進(jìn)行數(shù)據(jù)發(fā)送的改進(jìn),如下圖:
也可以直接進(jìn)入“傳輸錯(cuò)誤日志”功能,查看近期出現(xiàn)的所有錯(cuò)誤:
4、自檢查驗(yàn):確保所有《網(wǎng)絡(luò)預(yù)約出租汽車監(jiān)管信息交互平臺總體技術(shù)要求(貴州改)》文檔中所約定的28個(gè)接口都傳輸正常后,通過下圖所列相關(guān)功能開始自檢查驗(yàn)入庫后的數(shù)據(jù)是否和貴平臺發(fā)送的原始報(bào)文數(shù)據(jù)相符。
接口和功能對應(yīng)表如下:
5、檢查完所有接口數(shù)據(jù)都能正常入庫后,為保證傳輸數(shù)據(jù)安全,需對數(shù)據(jù)采用RSA非對稱加密算法進(jìn)行簽名。(網(wǎng)約車平臺可選擇不進(jìn)行RSA簽名直接傳送數(shù)據(jù),但因此導(dǎo)致數(shù)據(jù)接收異常和數(shù)據(jù)被篡改的情況由網(wǎng)約車平臺企業(yè)自行負(fù)責(zé))
a、說明:
傳輸方式POST(Content-Type:application/json)
簽名過程SHA1withRSA簽名進(jìn)行base64編碼字符集UTF-8。
b、格式
{"sign":"簽名后字符串","data":"數(shù)據(jù)JSON字符串"}
sign:簽名后的字符串
data:數(shù)據(jù)JSON字符串
樣例:
{"sign":"xxxxxxezFgQGfuC+Xen181KGU6OGlPsSTTt5hI3Yk7pPC/SYR8OmPe9vm+M0CSC6D7KXAw/ybfSeeOwjHQwb7zhTZbGMb1aFfK7Zng2lXk3rrfj3UWk/IXVzLmgwIA01DhrnjUHzvNuJffeTgDgGLk6bYUXZqhS0tVTc3vv1S9Y=","data":{"CompanyId":"xinlongjiaxin","Source":"368","IPCType":"vehicleposition","vehicleposition":[{"CompanyId":"1200DDCX3307","VehicleNo":"貴C1787F","VehicleRegionCode":5203,"PositionTime":1554343255,"Longitude":106948012,"Latitude":27693291,"Speed":12,"Direction":129,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"}]}}
c、傳輸方RSA簽名
把“數(shù)據(jù)JSON字符串”使用RSA私鑰簽名得到“簽名后的字符串”
RSA公鑰私鑰對(1024位)PKCS#8請向監(jiān)管平臺技術(shù)對接工程師申請。
測試時(shí)可使用http://www.metools.info/code/c82.html網(wǎng)址提供的工具進(jìn)行簽名的測試,使用該工具時(shí)請嚴(yán)格按照下圖指示進(jìn)行:
d、RSA簽名常遇錯(cuò)誤問題:
(1)、多余的空格和換行、回車字符會導(dǎo)致簽名錯(cuò)誤,請去除;
(2)、付點(diǎn)型的小數(shù),如果小數(shù)部分為0,請轉(zhuǎn)換為整型,如1.0已表示為1,否則也會出現(xiàn)簽名錯(cuò)誤的情況。
6、前面所述工作完成后,請?zhí)峤槐O(jiān)管平臺對接工程師進(jìn)行最后的數(shù)據(jù)核驗(yàn),核驗(yàn)成功就等待監(jiān)管平臺通知接入正式環(huán)境,正式環(huán)境接口地址屆時(shí)告知。到此數(shù)據(jù)對接工作完成,后期日常傳送數(shù)據(jù)過程中,如果出現(xiàn)相關(guān)錯(cuò)誤,監(jiān)管平臺方會通知貴平臺進(jìn)行錯(cuò)誤修正。
二、傳輸情況說明
貴州省網(wǎng)約車監(jiān)管平臺遵循交通運(yùn)輸部《網(wǎng)絡(luò)預(yù)約出租汽車監(jiān)管信息交互平臺總體技術(shù)要求(貴州改)》文件制定的標(biāo)準(zhǔn)。為了保證數(shù)據(jù)傳輸質(zhì)量,對數(shù)據(jù)質(zhì)量檢查較部標(biāo)準(zhǔn)會更加嚴(yán)格,特提醒以下注意事項(xiàng):
1、傳輸?shù)慕?jīng)緯度坐標(biāo)不能為無意義的0等坐標(biāo),新平臺對經(jīng)緯坐標(biāo)的要求范圍為:經(jīng)度大于70000000,小于140000000,維度大于0,小于55000000;
2、對日期時(shí)間,比如訂單時(shí)間、坐標(biāo)時(shí)間等當(dāng)前發(fā)生的時(shí)間,不能大于當(dāng)前時(shí)間+1天,不能小于當(dāng)前時(shí)間-3天。非當(dāng)前發(fā)生時(shí)間的,如許可證獲取日期、車輛年審日期等,不能小于2010-01-01;
3、優(yōu)先傳輸人、車、戶等基礎(chǔ)信息,否則傳輸數(shù)據(jù)時(shí)將出現(xiàn)錯(cuò)誤報(bào)告,車輛或駕駛員無法找到的錯(cuò)誤提示;
4、定位數(shù)據(jù)由于數(shù)據(jù)量大,建議一分鐘集中調(diào)用發(fā)送一次,如果一分鐘的定位數(shù)據(jù)包大于1M,可以半分鐘發(fā)送一次,如果依然數(shù)據(jù)量大,可與對接負(fù)責(zé)人具體商洽處理方案;
5、新平臺數(shù)據(jù)接收和入庫采取異步方式,接收后并非立即入庫,而是等待排隊(duì)處理,根據(jù)接口繁忙情況的不同,入庫延遲大概在1秒到1分鐘之間。
6、必須傳送Encrypt字段。
調(diào)用舉例,如發(fā)送車輛GPS定位數(shù)據(jù),具體接口地址為:http://czc.tyxxtb.com/position/vehicle
發(fā)送數(shù)據(jù)報(bào)文為:
{"CompanyId":"1200DDCX3307","Source":"0","IPCType":"positionvehicle","positionvehicle":[{"CompanyId":"1200DDCX3307","VehicleNo":"貴AV183F","VehicleRegionCode":5201,"PositionTime":1554343255,"Longitude":105642241,"Latitude":25505341,"Speed":0,"Direction":12,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴CE4767","VehicleRegionCode":5200,"PositionTime":1554343257,"Longitude":107039725,"Latitude":27702696,"Speed":0,"Direction":0,"Elevation":0,"Mileage":3,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴A1MS95","VehicleRegionCode":5201,"PositionTime":1554343258,"Longitude":106604620,"Latitude":26398930,"Speed":92,"Direction":125,"Elevation":0,"Mileage":0,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴C1106R","VehicleRegionCode":5203,"PositionTime":1554343255,"Longitude":106844215,"Latitude":27540118,"Speed":31,"Direction":285,"Elevation":0,"Mileage":1,"WarnStatus":1,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴A0TC71","VehicleRegionCode":5201,"PositionTime":1554343257,"Longitude":106713751,"Latitude":26580161,"Speed":0,"Direction":199,"Elevation":0,"Mileage":0,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴C1773E","VehicleRegionCode":5203,"PositionTime":1554342466,"Longitude":106811140,"Latitude":28142140,"Speed":0,"Direction":212,"Elevation":0,"Mileage":0,"WarnStatus":1,"VehStatus":2,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴C900A0","VehicleRegionCode":5203,"PositionTime":1554343259,"Longitude":106935156,"Latitude":27704035,"Speed":18,"Direction":356,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴A2V70C","VehicleRegionCode":5201,"PositionTime":1554343259,"Longitude":106426970,"Latitude":26632190,"Speed":11,"Direction":174,"Elevation":0,"Mileage":0,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴A2275A","VehicleRegionCode":5201,"PositionTime":1554343257,"Longitude":106612875,"Latitude":26635915,"Speed":0,"Direction":265,"Elevation":0,"Mileage":2,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴C1011H","VehicleRegionCode":5203,"PositionTime":1554343259,"Longitude":106853522,"Latitude":27588720,"Speed":25,"Direction":307,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"},{"CompanyId":"1200DDCX3307","VehicleNo":"貴C1787F","VehicleRegionCode":5203,"PositionTime":1554343255,"Longitude":106948012,"Latitude":27693291,"Speed":12,"Direction":129,"Elevation":0,"Mileage":1,"WarnStatus":0,"VehStatus":3,"OrderId":"0"}]}
三、常見問題解答
數(shù)據(jù)的傳輸方式,是我們按照文檔寫好接口調(diào)用還是有貴方來讀取?
答:按照對接文檔寫好調(diào)用我方平臺接口。
公司(/平臺)標(biāo)識或CompanyId是什么?是由貴州省網(wǎng)約車監(jiān)管平臺分配嗎?
答:如果你們有在交通部備案過,部里有分配給你們CompanyId作為你們的平臺標(biāo)識。如果沒在部里備案過,由貴州省網(wǎng)約車監(jiān)管平臺給你們分配標(biāo)識。
如何開通測試平臺數(shù)據(jù)對接的賬號?
答:將以下五項(xiàng)資料發(fā)送給平臺方的工程師,由他們來開通:
a、公司全稱;
b、在貴州那些市州有業(yè)務(wù);
c、公司有多少車;
d、如果已在交通部備案,請?zhí)峁┎坷锝o你們分配的CompanyId;
e、你方技術(shù)對接人的姓名及電話。
進(jìn)行數(shù)據(jù)對接工作是否需要技術(shù)工程師才能做?
答:數(shù)據(jù)對接需要以技術(shù)方式調(diào)用貴州省網(wǎng)約車監(jiān)管平臺,需要寫代碼實(shí)現(xiàn),所以必須由貴平臺的開發(fā)工程師才能完成。
我司/平臺已經(jīng)在貴陽做過數(shù)據(jù)對接,請問還需要重新做對接嗎?
答:由于全省平臺統(tǒng)一,所以在貴陽對接過的,不需要重新對接,只需要將數(shù)據(jù)發(fā)送的范圍從貴陽擴(kuò)大到全省。
我司/平臺在全省很多城市都在運(yùn)營,請問是每個(gè)城市單獨(dú)對接,還是由總部統(tǒng)一對接。
答:由總部統(tǒng)一對接。
Ptaxi猿著提供網(wǎng)約車軟件開發(fā)以及網(wǎng)約車牌照申請代辦、網(wǎng)約車監(jiān)管平臺數(shù)據(jù)對接服務(wù)等,如有需求歡迎咨詢我們!
更多資訊
Ptaxi猿著網(wǎng)約車軟件開發(fā):銅仁網(wǎng)約車百日整治,已查處4716起
Ptaxi猿著網(wǎng)約車行業(yè)10月監(jiān)管數(shù)據(jù)公布,滴滴、花小豬等平臺訂單增長超20%
滴滴打車軟件開發(fā)公司獲悉滴滴在5個(gè)城市上線特惠訂單相關(guān)的新規(guī)則
吉利網(wǎng)約車平臺"禮帽出行"杭州、大連、湖州三城啟動(dòng)正式運(yùn)營
Ptaxi猿著網(wǎng)約車牌照代辦獲悉騰訊出行戰(zhàn)略堅(jiān)持做網(wǎng)約車聚合平臺
北京市交通運(yùn)輸執(zhí)法總隊(duì)開展網(wǎng)約車平臺公司入戶檢查
網(wǎng)約車監(jiān)管信息交互系統(tǒng)發(fā)布9月份網(wǎng)約車行業(yè)運(yùn)行基本情況
每月持續(xù)產(chǎn)品迭代更新
快速Saas搭建+定制開發(fā)
專屬客戶經(jīng)理提供技術(shù)支持
提供企業(yè)合同及國家增值稅發(fā)票
產(chǎn)品
打車系統(tǒng) 定制客運(yùn) 出租車系統(tǒng) 電召系統(tǒng) 代駕系統(tǒng) 租車系統(tǒng) 順風(fēng)車系統(tǒng) 共享汽車系統(tǒng) 跑腿系統(tǒng)關(guān)注我們