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