Ptaxi網約車牌照代辦整理貴州省網約車監管平臺數據對接說明
2022-11-17 11:37:30 行業資訊Ptaxi網約車牌照代辦公司整理貴州省網約車監管平臺數據對接說明,跟著小編一起來看看吧!
一、數據對接流程
以下步驟請按先后順序完成:
1、申請貴州省網約車監管平臺測試環境數據對接賬號:
申請賬號需提供以下信息:
a、公司全稱;
b、在貴州那些市州有業務;
c、公司有多少車;
d、如果已在交通部備案,請提供部里給你們分配的CompanyId;
e、你方技術對接人的姓名及電話。
2、參照《網絡預約出租汽車監管信息交互平臺總體技術要求(貴州改)》文件制定的標準進行數據對接,平臺測試環境數據接收測試環境地址為:http://czc.tyxxtb.com/。如果調用相關數據對接接口返回200或ok則表示數據傳輸成功。
3、數據傳輸成功,不代表數據能夠正確入庫,有數據格式錯誤導致可能不能入庫的情況,所以在傳輸成功后,等待幾秒到幾分鐘的時間,可以在貴州省網約車監管平臺測試環境中通過“傳輸日志”功能查看數據是否入庫成功,入庫數量是否和原始報文相符。
如果入庫處理出現異常,請點擊進去查看異常原因,并針對提示進行數據發送的改進,如下圖:
也可以直接進入“傳輸錯誤日志”功能,查看近期出現的所有錯誤:
4、自檢查驗:確保所有《網絡預約出租汽車監管信息交互平臺總體技術要求(貴州改)》文檔中所約定的28個接口都傳輸正常后,通過下圖所列相關功能開始自檢查驗入庫后的數據是否和貴平臺發送的原始報文數據相符。
接口和功能對應表如下:
5、檢查完所有接口數據都能正常入庫后,為保證傳輸數據安全,需對數據采用RSA非對稱加密算法進行簽名。(網約車平臺可選擇不進行RSA簽名直接傳送數據,但因此導致數據接收異常和數據被篡改的情況由網約車平臺企業自行負責)
a、說明:
傳輸方式POST(Content-Type:application/json)
簽名過程SHA1withRSA簽名進行base64編碼字符集UTF-8。
b、格式
{"sign":"簽名后字符串","data":"數據JSON字符串"}
sign:簽名后的字符串
data:數據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簽名
把“數據JSON字符串”使用RSA私鑰簽名得到“簽名后的字符串”
RSA公鑰私鑰對(1024位)PKCS#8請向監管平臺技術對接工程師申請。
測試時可使用http://www.metools.info/code/c82.html網址提供的工具進行簽名的測試,使用該工具時請嚴格按照下圖指示進行:
d、RSA簽名常遇錯誤問題:
(1)、多余的空格和換行、回車字符會導致簽名錯誤,請去除;
(2)、付點型的小數,如果小數部分為0,請轉換為整型,如1.0已表示為1,否則也會出現簽名錯誤的情況。
6、前面所述工作完成后,請提交監管平臺對接工程師進行最后的數據核驗,核驗成功就等待監管平臺通知接入正式環境,正式環境接口地址屆時告知。到此數據對接工作完成,后期日常傳送數據過程中,如果出現相關錯誤,監管平臺方會通知貴平臺進行錯誤修正。
二、傳輸情況說明
貴州省網約車監管平臺遵循交通運輸部《網絡預約出租汽車監管信息交互平臺總體技術要求(貴州改)》文件制定的標準。為了保證數據傳輸質量,對數據質量檢查較部標準會更加嚴格,特提醒以下注意事項:
1、傳輸的經緯度坐標不能為無意義的0等坐標,新平臺對經緯坐標的要求范圍為:經度大于70000000,小于140000000,維度大于0,小于55000000;
2、對日期時間,比如訂單時間、坐標時間等當前發生的時間,不能大于當前時間+1天,不能小于當前時間-3天。非當前發生時間的,如許可證獲取日期、車輛年審日期等,不能小于2010-01-01;
3、優先傳輸人、車、戶等基礎信息,否則傳輸數據時將出現錯誤報告,車輛或駕駛員無法找到的錯誤提示;
4、定位數據由于數據量大,建議一分鐘集中調用發送一次,如果一分鐘的定位數據包大于1M,可以半分鐘發送一次,如果依然數據量大,可與對接負責人具體商洽處理方案;
5、新平臺數據接收和入庫采取異步方式,接收后并非立即入庫,而是等待排隊處理,根據接口繁忙情況的不同,入庫延遲大概在1秒到1分鐘之間。
6、必須傳送Encrypt字段。
調用舉例,如發送車輛GPS定位數據,具體接口地址為:http://czc.tyxxtb.com/position/vehicle
發送數據報文為:
{"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"}]}
三、常見問題解答
數據的傳輸方式,是我們按照文檔寫好接口調用還是有貴方來讀???
答:按照對接文檔寫好調用我方平臺接口。
公司(/平臺)標識或CompanyId是什么?是由貴州省網約車監管平臺分配嗎?
答:如果你們有在交通部備案過,部里有分配給你們CompanyId作為你們的平臺標識。如果沒在部里備案過,由貴州省網約車監管平臺給你們分配標識。
如何開通測試平臺數據對接的賬號?
答:將以下五項資料發送給平臺方的工程師,由他們來開通:
a、公司全稱;
b、在貴州那些市州有業務;
c、公司有多少車;
d、如果已在交通部備案,請提供部里給你們分配的CompanyId;
e、你方技術對接人的姓名及電話。
進行數據對接工作是否需要技術工程師才能做?
答:數據對接需要以技術方式調用貴州省網約車監管平臺,需要寫代碼實現,所以必須由貴平臺的開發工程師才能完成。
我司/平臺已經在貴陽做過數據對接,請問還需要重新做對接嗎?
答:由于全省平臺統一,所以在貴陽對接過的,不需要重新對接,只需要將數據發送的范圍從貴陽擴大到全省。
我司/平臺在全省很多城市都在運營,請問是每個城市單獨對接,還是由總部統一對接。
答:由總部統一對接。
Ptaxi猿著提供網約車軟件開發以及網約車牌照申請代辦、網約車監管平臺數據對接服務等,如有需求歡迎咨詢我們!
更多資訊
Ptaxi猿著網約車軟件開發:銅仁網約車百日整治,已查處4716起
Ptaxi猿著網約車行業10月監管數據公布,滴滴、花小豬等平臺訂單增長超20%
滴滴打車軟件開發公司獲悉滴滴在5個城市上線特惠訂單相關的新規則
每月持續產品迭代更新
快速Saas搭建+定制開發
專屬客戶經理提供技術支持
提供企業合同及國家增值稅發票