




版權說明:本文檔由用戶提供并上傳,收益歸屬內容提供方,若內容存在侵權,請進行舉報或認領
文檔簡介
ICS03.220.20CCSR85T/QME0015-2024I前言 12規范性引用文件 3術語和定義 4縮略語 5接入框架 5.1接入框架 25.2青島智慧停車一體化平臺組成 25.3接入關系 36接入流程 6.1概述 36.2接入申請 46.3接入審核 46.4接入測試 46.5正式接入 57接口要求 7.1概述 57.2青島智慧停車一體化平臺接入 5附錄A(資料性)青島智慧停車一體化平臺接入申請表 8A.1青島智慧停車一體化平臺接入申請表 8附錄B(資料性)青島智慧停車一體化平臺接入接口信息 9B.1通用接口規范 9B.2系統安全對接 B.3上行業務接口協議 17B.4下行業務接口協議 33B.5相關業務流程 48B.6數據字典 T/QME0015-2024本文件由青島華通智能科技研究院有限公司、青島華睿互聯科技有限責任公司、青島市機械電子工程學會聯合提出。本文件由青島市機械電子工程學會歸口。本文件的有些內容可能涉及專利,對于本文件中有關專利問題的處理,參照國家標準化委員會《國家標準涉及專利的管理規定(暫行)》的有關規定處理。本文件的發布機構不承擔識別這些專利的責任。本文件起草單位:青島華通智能科技研究院有限公司、青島華睿互聯科技有限責任公司、松立控股集團股份有限公司、深圳市捷順科技實業有限公司、青島瑞柵電子有限公司、北京四維圖新科技股份有限公司、吉林大學青島汽車研究院、青島市機械電子工程學會。本文件主要起草人:明磊、王文彥、劉寒松、王永、李德明、王偉、劉瑞、李越、劉志強、李茂飛、周志強。1T/QME0015-2024青島市全市一個停車場聯網接入協議規范本文件給出了停車場聯網接入的術語和定義、系統構成與功能性能要求和檢驗驗收的指導。描述了青島智慧停車一體化平臺對接停車場端的http接口協議,包括接口定義、數據格式、參數和返回信息等,滿足停車場系統與青島智慧停車一體化平臺對接需求。本文件適用于停車場聯網接入青島智慧停車一體化平臺的建設和檢驗驗收。2規范性引用文件下列文件中的內容通過文中的規范性引用而構成本文件必不可少的條款。其中,注日期的引用文件,僅該日期對應的版本適用于本文件;不注日期的引用文件,其最新版本(包括所有的修改單)適用于本文件。GB/T9813-2017計算機通用規范GB/T18894-2016電子文件歸檔與電子檔案管理規范GB/T29264-2012信息技術服務分類與代碼GB/T37078-2018出入口控制系統技術要求GA381-2002公共數據交換格式GA/T687-2007信息安全技術公鑰基礎設施安全技術要求GA/T739-2007公安請求服務平臺應用規范GA/T833-2009機動車號牌圖像自動識別技術規范GA/T1400-2017公安視頻圖像信息應用系統ISO/IEC17799/BS7799-1信息安全管理體系實施指南3術語和定義下列術語和定義適用于本文件。3.1令牌Tokentoken是服務端生成的一串字符串,以作客戶端進行請求的一個令牌,當第一次登錄后,服務器生成一個token便將此token返回給客戶端,以后客戶端只需帶上這個token前來請求數據即可,無需再次帶上用戶名和密碼。3.2文本傳輸格式JSON是一種數據交換格式,是純文本的字符串。3.32T/QME0015-2024對象存儲OSSOSS(ObjectStorageService)是一種海量、安全、低成本、高可靠的云存儲服務,適合存放任意類型的文件。容量和處理能力彈性擴展,多種存儲類型供選擇,全面優化存儲成本。3.4停車場系統Parkingsystem與市級平臺進行數據交互的運營商停車平臺或者停車站級軟件均稱為停車場系統。4縮略語下列縮略語適用于本文件:URL:統一資源定位器(UniformResourceLocator)HTTP:超文本傳輸協議(HyperTextTransferProtocol)GUID:微軟對UUID這個標準的實現(GlobalsUjiqueIdentifiers)PDF:可移植文檔格式(PortableDocumentFormat)MD5:一種被廣泛使用的密碼散列函數,可以產生出一個128位(16字節)的散列值(hashvalue用于確保信息傳輸完整一致。5接入框架5.1接入框架平臺接入框架見圖1。停車場已經接入所屬運營商平臺的,應接入青島智慧停車一體化平臺;停車場未接入所屬運營商平臺或所屬運營商沒有平臺的,應通過停車場前端軟件接入青島智慧停車一體化平臺。圖1接入框架5.2青島智慧停車一體化平臺組成3T/QME0015-2024青島智慧停車一體化平臺由數據匯聚管理系統、運營服務系統、管理服務系統組成,具體內容包括:運營服務系統:應提供全市停車場運營服務功能;管理服務系統:應提供全市停車場管理服務功能;數據匯聚管理系統:應提供青島智慧停車一體化平臺接入相關接口。5.3接入關系停車場系統與青島智慧停車一體化平臺系統對接關系主要包括:a)停車場系統根據接口文檔定義的接口規范和協議,構造請求數據,包括客戶號、令牌、標簽b)停車場系統根據提供的接口地址(根據對接開發階段分調試接口地址和正式接口地址),向青島智慧停車一體化平臺發送請求;c)青島智慧停車一體化平臺接收到停車場系統的請求后,對請求參數進行校驗、格式轉換、執行業務邏輯等處理過程,最后返回處理結果;d)停車場系統根據青島智慧停車一體化平臺返回的結果做進一步處理。6接入流程6.1概述停車場系統應按照圖2規定的接入流程要求接入青島智慧停車一體化平臺。4T/QME0015-2024圖2接入流程6.2接入申請停車場系統應依據車場實際情況填寫接入申請表,獲取對接協議規范文檔,主要包括:a)申請青島智慧停車一體化平臺接入的,應按附錄A.1的要求填寫青島智慧停車一體化平臺接入申請表;b)遵守附錄B的青島市全市一個停車場聯網接入協議規范開發協議接口,對接青島智慧停車一體化平臺;6.3接入審核青島智慧停車一體化平臺主管部門應對停車場系統提交的申請材料進行審核。審核通過后,青島智慧停車一體化平臺提供調試環境的客戶號,以及調試賬號、密碼、密鑰(數據加密使用),提供給停車場系統。停車場系統應在前端軟件或企業級平臺的測試環境上與青島智慧停車一體化平臺服務接口進行聯6.4接入測試5T/QME0015-2024停車場系統根據接口文件定義的規范和協議,訪問青島智慧停車一體化平臺調試服務器提供的接口服務,完成對接開發工作,青島智慧停車一體化平臺主管部門應提供對接測試環境和技術支持服務,配合指導停車場系統完成開發測試工作。6.5正式接入接入測試工作完成后,青島智慧停車一體化平臺提供正式環境的客戶號,創建正式賬號和密碼及密鑰,并提供給停車場系統。停車場系統把對接開發的內容部署到生產環境,并把調試接口地址改為正式接口地址。7接口要求7.1概述停車場系統接入應按要求開發相應接口,將企業級停車場平臺或停車場道閘軟件系統接入青島智慧停車一體化平臺。接口信息應包括接口分類、接口名稱、接口功能描述、請求方式、請求地址、輸入/輸出參數等信息。7.2青島智慧停車一體化平臺接入青島智慧停車一體化平臺接入接口包括車場信息上傳、車輛出入場信息上傳、車輛收費記錄上傳等,接口目錄應符合表1的要求。青島智慧停車一體化平臺接入接口請求方式、請求地址、輸入/輸出參數等接口信息見附錄B。表1青島智慧停車一體化平臺接入接口目錄序號接口分類接口名稱接口功能描述1上行接口車場信息上傳用于新建一個停車場或者停車場信息變更時,將停車場基礎信息上傳到平臺。停車場系統調用車場信息上傳接口推送車場信息給青島智慧停車一體化平臺。2場內車輛數上傳停車場系統調用青島智慧停車一體化平臺接口主動推送車場已占車位數信息。3車輛入場信息上傳停車場系統調用青島智慧停車一體化平臺接口主動推送車輛入場信息。車輛進車場時調用,當檢測到車輛進場并識別出車牌號后,將生成的車輛進場訂單信息上傳。4車輛出場信息上傳停車場系統調用青島智慧停車一體化平臺接口主動推送車輛出場信息。道閘系統放行車輛出場之后,道閘系統將該車出場信息上傳,上傳信息為該車牌從入場到出場的全部信息及總費用,上傳失敗支持重傳。5文件接口協議停車場系統調用青島智慧停車一體化平臺接口文件上傳接口,上傳圖片文件,車輛出入場時,對應上傳車輛的出入場照片,出入場圖片使用阿里云OSS方式存儲。6車輛收費記錄上傳停車場系統調用青島智慧停車一體化平臺接口主動推送車輛收費記錄。車輛結算完成,道閘系統將該條訂單信息上傳,上傳信息為該車牌從入場到支付完成的全部信息,上傳失敗支持重傳。6T/QME0015-20247車場臨時車收費標準上傳停車場系統調用青島智慧停車一體化平臺接口主動推送車場臨時收費標準信息,用于移動端車場信息展示時的收費信息展示,上傳失敗支持重傳。8設備信息上傳用于新接入硬件設備時,將設備信息注冊到管理平臺,停車場系統調用青島智慧停車一體化平臺接口主動推送設備信息,上傳失敗支持重傳。9設備狀態信息上傳停車場系統調用青島智慧停車一體化平臺接口主動推送車場設備狀態信息。套餐信息上傳停車場系統調用青島智慧停車一體化平臺接口主動推送套餐信息,停車場系統定制的共享停車套餐(包月共享、包次共享)通過此接口上傳至平臺,供車主購買共享服務。車場月收費標準上傳停車場系統調用青島智慧停車一體化平臺接口主動推送車場月收費標準信息。無感車牌反查入場記錄上報后,若停車場免費停車時間內或車輛出場時未下發無感車牌通知,則運營商場站應在車輛出場前調用此接口,主動查詢該車輛是否為無感車牌。發起主動扣款請求車主同青島智慧停車一體化平臺簽約,開通無感支付,支持先扣后出,在出口識別到車牌后,車場系統需要發起扣款請求,請求平臺進行扣款,請求失敗支持重傳。訂單支付結果反查車主支付成功通知后,由青島智慧停車一體化平臺下發成功通知是一種數據交換格式,是純文本的字符串。停車場系統。當道閘軟件識別到車牌,彈出停車訂單信息后,為防止支付成功通知下發失敗,停車場系統可以通過此接口主動調用訂單支付結果。車位狀態信息上傳車輛駛入車位后,停車場識別到車位狀態發生改變,將狀態信息及停入車輛信息上傳平臺,請求失敗支持重傳。下行接口變更下發用戶通過平臺購買共享車位訂單或月卡訂單,用戶購買成功后平臺會將月卡信息下發到停車場,購買了月卡的車牌號在有效時間段內進出場直接抬桿放行,在有效時間段內停車不計費。此接口為平臺下發,道閘系統接收到下發的月卡訂單,只需要將車牌號添加到收費系統中即可,有效期為套餐開始時間和套餐結束時間,如果系統中已經存在該車牌號,則更新套餐起止時間,不需要作時間的校驗,平臺在下發時已經進行了套餐有效期的校驗。套餐的開始時間和套餐結束時間為車牌的有效期。月卡注銷用戶購買月卡后,在滿足退款條件下可以取消訂單并退款,用戶退款后平臺會將用戶取消訂單的消息下發給停車場,注銷對應的月卡信息。請求獲取訂單信息青島智慧停車一體化平臺通過車牌號向指定停車場系統查詢車輛的訂單信息。線上支付成功通知下發用戶通過移動端支付、掃碼付、無感支付等多種支付方式支付費用成功后,青島智慧停車一體化平臺下發線上支付成功通知到停車場系統,車場收到通知后,開閘放行。T/QME0015-2024無感車牌通知下發車輛入場,停車場系統上報入場記錄之后,青島智慧停車一體化平臺將無感車輛檢驗結果下發給停車場系統。場內無感車牌狀態變更車輛入場后,車主在青島智慧停車一體化平臺進行開通無感支付或取消無感支付操作,青島智慧停車一體化平臺將無感車牌狀態變更結果下發給停車場系統。掃描靜態碼獲取訂單請求車場將出口通道設備綁定到靜態二維碼上,車主出場掃描二維碼時,可根據綁定的設備號判斷車主所在出口通道,道閘軟件識別到該出口通道的車牌號,根據車牌生成訂單返回。臨時車收費標準信息下發青島智慧停車一體化平臺創建的臨停車收費標準可以下發到指定停車場系統,車場可使用下發的臨停車收費標準進行車場臨停收費。刪除臨時車收費標準信息下發青島智慧停車一體化平臺根據記錄ID可將下發到停車場系統臨時套餐信息刪除。車場月收費標準信息下發青島智慧停車一體化平臺創建的月卡套餐可以下發到指定停車場系統,移動端用戶可通過線上購買車場月卡,進行包月停刪除車場月收費標準信息下發青島智慧停車一體化平臺根據記錄ID可將下發到停車場系統月卡套餐信息刪除。車場黑白名單新增/修改下發青島智慧停車一體化平臺下發黑白名單信息到停車場系統。車場黑白名單刪除下發青島智慧停車一體化平臺將下發到停車場系統的黑白名單信息刪除。8T/QME0015-2024(資料性)青島智慧停車一體化平臺接入申請表A.1青島智慧停車一體化平臺接入申請表青島智慧停車一體化平臺接入申請表見表A.1。表A.1青島智慧停車一體化平臺接入申請表項目名稱項目地址項目高德坐標車位數量建筑類型所在區建設/產權/運營單位設備品牌聯系人及電話是否政府定價是否備案備案日期備注填表人填表時間填表說明1.高德地圖的坐標請通過高德地圖坐標拾取系統獲取:/tools/picker。2.建筑類型包括:地面、地下。3.所在區為市南區、市北區、李滄區、嶗山區、黃島區、城陽區、即墨區、膠州市、平度市、萊西市。9T/QME0015-2024(資料性)青島智慧停車一體化平臺接入接口信息B.1通用接口規范上行通用接口規范數據接入地址http://serverUrl/postfixUrlserverUrl:[青島智慧停車一體化平臺域名]:[停車場接入服務端口]postfixUrl:具體業務地址,該地址不會變(如:車場信息上傳為parkInfo)通用上傳請求說明描述:青島智慧停車一體化平臺集成停車場系統對外開放的統一接口,根據參數完成對應的功能。編碼格式統一為:UTF-8請求方式統一為:POSTurl:http://serverUrl/postfixUrl請求參數結構data:{"cno":"客戶號","subCode":"項目編號","tn":"令牌","seq_id":"請求唯一ID,使用GUID",}lcno:客戶號(customerNo)lsubCode:項目編號(由青島智慧停車一體化平臺統一下發)ltn:令牌(token)lseq_id:請求ID(自定義GUID,32位以內)lsn:簽名(signature使用MD5算法對參數data值和passKey(密鑰)生成的簽名,值為大寫。規則如下:sn=md5(data+passkey)如:md5({"cno":"客戶號","subCode":"項目編號","tn":"令牌","seq_id":"請求id","p":{業務參數p(parameter)}}+passkey)簽名以鍵值對的形式(sn=XXXXX)存儲在消息頭里面lp:業務參數(parameter),JSON格式字符串,具體內容及構造方式,見詳細接口協議"data_items":[{"參數名2":"參數值2",..."參數名3":"參數值3","參數名4":"參數值4",T/QME0015-2024...}......}參數P內容說明:a)參數PJSON字符串固定屬性標簽包括:標簽名稱說明data_items一級子對象列表結構標簽接口參數合集,Json類型b)數據類型標簽名稱說明String字符串Char字符Short短整數-32768至32768整數-2147483648至2147483648Long長整數-9233372036854477808至9233372036854477808Float浮點數-3.40292347E+38至3.40292347E+38Double雙精度-1.79769313486231570E+308至1.79769313486231570E+308Boolean布爾true:是;false:否Date格式:yyyy-MM-ddDateTime格式:yyyy-MM-ddHH:mm:ssTimeStamp時間戳從1970年1月1日0時0分0秒到當前時間的毫秒數,基礎數據類型LongGuid唯一標識不帶分隔符的32位字符串T/QME0015-2024Array對象數組Object對象其他基本數據類型的組合通用上傳響應說明響應格式:JSON格式字符串結構{"result_code":result_code值,"message":"消息","seq_id":"請求id,使用GUID,返回數據與請求數據相同","data_items":[{"item_id":"item_id值","error_code":error_code值,"error_message":"".........}屬性名稱類型長度必須說明seq_idString是為兼容期間暫定否,如果請求數據有,返回數據與請求數據須相同result_code返回碼是B.1.1.4異常列表message返回消息String否B.1.1.4異常列表data_items結果集否返回值一級標簽item_id記錄唯一標識String是返回值二級標簽,記錄唯一標識error_code業務數據返是返回值二級標簽error_message失敗消息String否返回值二級標簽T/QME0015-2024注意:result_code=0,data_items為空時,表示本次請求數據全部成功result_code=0,data_items不為空時,表示本次請求有部分數據處理成功,部分數據處理不成功,具體詳情見data_items中的值,根據code來判斷該記錄是否處理成功result_code=1,表示本次請求的數據全部處理失敗,data_items可能為空異常列表標簽名稱說明result_code返回碼取值:0:成功1:處理失敗(接口報錯)100:請求參數為空101:客戶號為空102:賬號為空103:密碼為空104:sign為空105:token為空106:parameter為空107:data_items為空110:用戶不存在111:密碼錯誤112:無效的數據簽名113:無效的令牌或令牌過期114:parameter格式錯誤115:客戶號不存在116:IP未綁定117:賬號不存在118:客戶號或IP不正確或登錄已超時119:參數長度超過限制或格式不正確error_code業務數據返回碼取值:0:成功1:失敗圖片存儲及格式規范1)車輛圖像捕獲率不低于99%(任何環境因素下都滿足);2)圖像應能清晰顯示當前車輛號牌信息,車輛基本特征信息,并能記錄拍攝時間、拍攝地點、設備編號等信息;3)圖像文件應具備防篡改功能;4)圖像在系統中保存時間不得少于1個月;5)拍攝圖像應以JPEG方式存儲;6)圖像分辨率不低于1280×720像素;7)圖像顏色不低于24位真彩色;8)單張圖像大小不小于20KB,且不大于500KB;9)圖像應能清晰顯示當前車輛號牌信息,圖像中的號牌圖像水平分辨率不低于100個像素點;T/QME0015-202410)圖像相關信息應當真實、完整,應能以OSD疊加或文件名代碼規則表示原始信息,至少包含拍攝時間、拍攝地點、設備編號、防偽信息等信息;11)圖片采用阿里云OSS存儲,圖片訪問權限必須為:公共讀寫。下行通用接口規范下行通用對接說明描述:停車場系統對接青島智慧停車一體化平臺,停車場系統主動上傳的數據對接方式參照上行業務接口協議,考慮到停車場系統不一定具備固定IP的條件,青島智慧停車一體化平臺下發到停車場系統的數據統一采用MQTT的對接形式。服務端發送主題:thirdpark/server_send/MQTT帳號客戶端發送主題:thirdpark/client_send/MQTT帳號數據下發,青島智慧停車一體化平臺作為服務端,停車場系統作為客戶端,青島智慧停車一體化平臺把業務數據寫到服務端發送主題,停車場系統把響應結果寫到客戶端發送主題通用下發參數說明青島智慧停車一體化平臺下發的數據統一采用MQTT的對接形式,數據內容都是JSON字符串。停車場系統根據cmd_type來區分對應的業務數據屬性名稱類型必須說明seq_id請求IDString是Guid,請求的唯一標識cmd_type業務類型String是停車場系統根據cmd_type來區分對應的業務數據project_code項目編號String是項目唯一標識,由青島智慧停車一體化平臺統一下發,一個MQTT帳號綁定多個項目時,停車場系統可根據該字段下發到對應的項目,與其他接口中的項目編號一致data_items業務數據集合String是通用下發響應說明響應格式:JSON格式字符串。屬性名稱類型必須說明result_code返回碼是0:成功,1:失敗message返回消息String否錯誤信息cmd_type業務類型String是和請求參數的cmd_type保持一致seq_id請求IDString是和請求參數里的seq_id一致T/QME0015-2024data_items業務集合String否注意:result_code=0,data_items為空時,表示本次請求數據全部成功result_code=0,data_items不為空時,表示本次請求有部分數據處理成功,部分數據處理不成功,具體詳情見data_items中的值,根據code來判斷該記錄是否處理成功。result_code=1,表示本次請求的數據全部處理失敗,data_items可能為空。B.2系統安全對接上行安全接入登錄描述:停車場系統訪問青島智慧停車一體化平臺的業務功能時,需先調用登錄接口,獲取令牌。url:http://serverUrl/login請求方式:POST屬性名稱類型長度必須說明cno客戶號String是usr賬號String是psw密碼String是返回值:JSON格式字符串屬性名稱類型長度必須說明result_code返回碼是參考B.1.1.4異常列表message返回消息String否參考B.1.1.4異常列表token令牌String否在訪問業務功能前先登錄獲取令牌timeOut有效期間Long是單位秒,-1:永久有效注銷描述:停車場系統主動注銷登錄狀態。url:http://serverUrl/logout請求方式:POST屬性名稱類型長度必須說明cno客戶號String是TokenString是返回值:JSON格式字符串T/QME0015-2024屬性名稱類型長度必須說明result_code返回碼是參考B.1.1.4異常列表message返回消息String否參考B.1.1.4異常列表如下描述的所有業務接口協議的內容,都是p參數的詳細描述,停車場系統在請求時,必須按照上述請求格式示例進行數據填充,除此之外,還需要提供數據前面sn的值。返回碼說明result_code=0代表本次業務請求成功,并不代表業務處理成功;result_code=1代表本次請求失敗(業務處理同樣失敗)。在返回參數內層可能會帶有error_code字段(=0/1),此字段表明對應的數據是業務處理成功還是業務處理失敗,error_code=0或者為空,表示單條業務處理成功,error_code=1表示單條業務處理失敗。result_code值含義如下:含義含義0請求成功1請求失敗請求參數為空token為空sign為空cno為空cno不存在cno對應的項目不存在/usr為空token無效或過期sign不匹配psw為空登錄賬號超過20位長度Usr不存在密碼錯誤特別說明1.時間格式約定為unix時間戳,定義為格林尼治標準時間1970年01月01日00時00分00秒(北京時間1970年01月01日08時00分00秒)起至現在的總秒數,共10位數字。如1502338835表示北京時間2017年8月10日12點20分35秒。客戶端每次請求都帶上當前時間戳參數timestamp。2.車牌號碼統一使用“省-號碼”的形式,如:魯-B6666793.token:提供給運營商接入的唯一標識符身份令牌,服務端用來做token校驗的參數,每個接口調用都要帶上;4.上行業務接口超時時間為20秒,如車輛出入場類接口如果遇到超時失敗,請重新調用。5.系統應具備斷線重連機制,上行業務接口傳輸失敗后,間隔5分鐘請重復上傳,重復50次為止。6.接口中所有的【項目編號】字段對應值一致,由青島智慧停車一體化平臺統一下發。7.一個項目可對應一個或多個停車場,多個停車場根據【車場ID】和【車場編號】區分。下行對接授權T/QME0015-2024登錄描述:停車場系統調用集成服務獲取MQTT對接所需的業務參數,登錄客戶號、賬戶、密碼參數與上行接口的登錄客戶號、賬戶、密碼一致。url:http://serverUrl/mqtt/login請求方式:POST屬性名稱類型長度必須說明cno客戶號String是青島智慧停車一體化平臺提供usr賬號String是青島智慧停車一體化平臺提供psw密碼String是青島智慧停車一體化平臺提供返回值:JSON格式字符串屬性名稱類型必須說明result_code返回碼是參考B.1.1.4異常列表message返回消息String否參考B.1.1.4異常列表client_idmqtt客戶端IDString否在訪問業務功能前先登錄獲取客戶端client_user_namemqtt客戶端賬號String否在訪問業務功能前先登錄獲取客戶端賬號client_passwordmqtt客戶端密碼String否在訪問業務功能前先登錄獲取客戶端密碼綁定項目描述:停車場系統調用集成服務綁定MQTT帳號與項目關系,一個MQTT帳號可管理多個項目,數據統一推送至該MQTT帳號對應的主題,停車場系統可根據project_code分發到具體的項目。每當有新車場接入時,需調用此接口將車場所在的項目與MQTT帳號綁定。url:http://serverUrl/mqtt/bindprojects請求方式:POST屬性名稱類型長度必須說明user_nameMQTT客戶端帳號String是調用登錄接口獲取(client_user_name)projects項目列表Object是JSON格式code項目編號String是由青島智慧停車一體化平臺統一下發,其他接口中的項目編號一致status狀態是1:正常2:刪除返回值:JSON格式字符串T/QME0015-2024屬性名稱類型必須說明result_code返回碼是0:成功,1:失敗message返回消息String否data_items業務集合Object否error_code業務響應編號是0:業務成功1:業務失敗error_message業務響應描述String否注意:result_code=0,data_items為空時,表示本次請求數據全部成功result_code=0,data_items不為空時,表示本次請求有部分數據處理成功,部分數據處理不成功,具體詳情見data_items中的值,根據code來判斷該記錄是否處理成功。result_code=1,表示本次請求的數據全部處理失敗,data_items可能為空。B.3上行業務接口協議基礎數據,如人員,車輛,區域,設備等信息等基礎信息發生變化,需要以增量的方式進行上傳;業務數據,如出入場等數據需要及時上傳。車場信息上傳B.3.1.1接口協議描述:用于新建一個停車場或者停車場信息變更時,將停車場基礎信息上傳到平臺。停車場系統調用車場信息上傳接口推送車場信息給青島智慧停車一體化平臺,每24小時內上傳一次。頻率:24小時一次,無論車場狀態是否有變化,上傳失敗支持重傳。場景:停車基本信息上傳請求url:http://serverUrl/thirdAPI/parkinfo業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明item_idString是記錄ID(全球唯一標識32位Guid)park_code車場編號String是park_name車場名稱String是total_count總車位數是total_order_count可預訂總車位數否delete_flag車場狀態Boolean是描述該車場信息是否已刪除(true:已刪除;false:未刪除),默認值falseT/QME0015-2024lock_flag是否支持鎖車是0:不支持鎖車,1:支持鎖車timestamp時間戳Long是時間戳,每更新一次都需要更新返回值:JSON格式字符串屬性名稱類型長度必須說明result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否item_idString是記錄ID(全球唯一標識32位Guid)error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗場內車輛數上傳B.3.1.2接口協議描述:停車場系統調用青島智慧停車一體化平臺接口主動推送車場已占車位數信息,每1分鐘上傳一次。頻率:1分鐘一次,無論剩余車位數是否有變化,上傳失敗無須重傳。場景:停車基本信息上傳請求url:http://serverUrl/thirdAPI/parkspace業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明park_idString是in_space_count車場已占車位數量是book_space_count預定車輛數是若無預訂業務,填0remain_space_count剩余車位數是timestamp時間戳Long是時間戳,每更新一次都需要更新返回值:JSON格式字符串屬性名稱類型長度必須說明result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否T/QME0015-2024parkIdString是與請求參數相同error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗error_message業務處理返回信息String否車輛入場信息上傳B.3.1.3接口協議描述:停車場系統調用青島智慧停車一體化平臺接口主動推送車輛入場信息。車輛進車場時調用,當檢測到車輛進場并識別出車牌號后,將生成的車輛進場訂單信息上傳。上傳成功后通過【無感車牌通知下發】返回車輛是否支持無感支付。如果車場免費停車時間范圍內或車場出場時未收到【無感車牌通知下發】,通過【無感車牌反查】接口主動查詢車輛是否支持無感支付。如果車輛在車場內期間用戶類型發生變化,則通過【場內無感車牌狀態變更】接口下發修改,道閘更新車牌狀態,車輛出場時以修改后的用戶類型為準,上傳失敗支持重傳。請求url:http://serverUrl/thirdAPI/carIn場景:停車基本信息上傳業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明item_id車輛入場記錄String是event_type事件類型String是參見<B.6.1.7車場事件類型>car_no車牌號碼String是car_color車牌顏色String是參見<B.6.1.26車牌顏色>in_time車輛入場時間String是in_equipment_id入場設備IDString否參見<B.3.8設備信息item_id>park_idString是參見<B.3.1車場信息item_id>io_type出入口類型是參見<B.6.1.30車場出入口類型>timestamp時間戳Long是時間戳,每更新一次都需要更新返回值:JSON格式字符串屬性名稱類型長度必須說明result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否item_id車輛入場記錄IDString是與請求參數相同T/QME0015-2024error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗error_message業務處理返回信息String否車輛出場信息上傳B.3.1.4接口協議描述:停車場系統調用青島智慧停車一體化平臺接口主動推送車輛出場信息。道閘系統放行車輛出場之后,道閘系統將該車出場信息上傳,上傳信息為該車牌從入場到出場的全部信息及總費用,上傳失敗支持重傳。請求url:http://serverUrl/thirdAPI/carOut場景:停車基本信息上傳業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明item_id車輛出場記錄String是記錄ID(全球唯一標識32位Guid)park_idString是參見<B.3.1車場信息item_id>event_type事件類型String是參見<B.6.1.7車場事件類型>car_no車牌號碼String是car_color車牌顏色String是參見<B.6.1.26車牌顏色>out_time出場時間String是格式為:yyyy-MM-ddHH:mm:ssout_equipment_idString否參見<B.3.8設備信息item_id>ys_money應收金額Decimal(12,2)是保留兩位小數(單位:元),入場到出場間產生的應收金額總和ss_money實收金額Decimal(12,2)是保留兩位小數(單位:元),入場到出場間產生的實收金額總和yh_money優惠打折金額Decimal(12,2)否保留兩位小數(單位:元),入場到出場間產生的優惠金額總和park_in_id車輛入場記錄String是in_time入場時間String是格式為:yyyy-MM-ddHH:mm:ssremark備注String500否T/QME0015-2024io_type出入口類型是參見<B.6.1.30車場出入口類型>timestamp時間戳Long是時間戳,每更新一次都需要更新返回值:JSON格式字符串屬性名稱類型長度必須說明result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否item_id車輛出場記錄IDString是與請求參數相同error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗error_message業務處理返回信息String否文件接口協議描述:停車場系統調用青島智慧停車一體化平臺接口文件上傳接口,上傳圖片文件,車輛出入場時,對應上傳車輛的出入場照片,出入場圖片使用阿里云OSS方式存儲。圖片存儲使用當天日期(例:20210730)為目錄,然后把相應圖片上送到此目錄下,上傳失敗支持重傳。【項目編號】字段與其他接口值一致,由青島智慧停車一體化平臺統一下發。類型路徑描述入場圖片項目編號/NISSP_IMG_PARK_IN/入場時間(yyyyMMdd格式)/入場記錄ID,入場紀錄ID與入場記錄上傳中的item_id對應。出場圖片項目編號/NISSP_IMG_PARK_OUT/出場時間(yyyyMMdd格式)/出場記錄ID,出場紀錄ID與出場記錄上傳中的item_id對應。場景:停車基本信息上傳車輛收費記錄上傳T/QME0015-2024B.3.1.5接口協議描述:停車場系統調用青島智慧停車一體化平臺接口主動推送車輛收費記錄。車輛結算完成,道閘系統將該條訂單信息上傳,上傳信息為該車牌從入場到支付完成的全部信息,上傳失敗支持重傳。請求url:http://serverUrl/thirdAPI/carcharge場景:停車基本信息上傳業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明item_id車輛收費記錄String是記錄ID(全球唯一標識32位Guid)park_idString是car_no車牌號碼String是表示車牌號碼in_time入場時間String是格式為:yyyy-MM-ddcharge_time計費時間String是格式為:yyyy-MM-ddpark_in_id車輛入場IDString是ys_money應收金額Decimal(12,2)是保留兩位小數(單位:元)ss_money實收金額Decimal(12,2)是保留兩位小數(單位:元)yh_money優惠打折金額Decimal(12,2)否保留兩位小數(單位:元)charge_type收費類型String否參見<B.6.1.27車輛收費類型>pay_type付款方式String是參見<B.6.1.9付款方式>pay_from支付來源String是如:"支付寶"、"微信"、"錢包"、"第三方"timestamp時間戳Long是時間戳,每更新一次都需要更新replace_deduct無感標識是0:未開通1:開通無感app_userid無感用戶IDString否在【無感車牌通知下發】接口中返回此值calc_money計費金額Decimal(12,2)否本次入場到出場總的應支付T/QME0015-2024金額,單位:元person_name用戶名稱String否pay_status付款標識否1:已付款2:已退款paid已支付金額Decimal(12,2)否單位:元orderIdString否線上訂單IDorder_create_time訂單生成時間String否線上訂單生成時間,格式:Yyyy-MM-ddHH:mm:ss返回值:JSON格式字符串屬性名稱類型長度必須說明result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗error_message業務處理返回信息String否車場臨時車收費標準上傳B.3.1.6接口協議描述:停車場系統調用青島智慧停車一體化平臺接口主動推送車場臨時收費標準信息,用于移動端車場信息展示時的收費信息展示,每24小時內上傳一次,上傳失敗支持重傳。頻率:24小時一次,無論收費標準是否有變化。請求url:http://serverUrl/thirdAPI/standardinfo場景:停車基本信息上傳業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明item_id車場臨時收費標準IDString是park_idString是charge_standard_name收費標準名稱String200是charge_standard_content標準內容String是參見如下實例說明T/QME0015-2024timestamp時間戳Long是時間戳,每更新一次都需要更新返回值:JSON格式字符串屬性名稱類型長度必須說明result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否item_id車場臨時收費標準IDString是與請求參數相同error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗error_message業務處理返回信息String否設備信息上傳B.3.1.7接口協議描述:用于新接入硬件設備時,將設備信息注冊到管理平臺,停車場系統調用青島智慧停車一體化平臺接口主動推送設備信息,每24小時內上傳一次,上傳失敗支持重傳。頻率:24小時一次,無論設備狀態是否有變化。請求url:http://serverUrl/thirdAPI/equipinfo場景:靜態碼支付業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明item_idString是記錄ID(全球唯一標識32位Guid)equip_code設備編號或機號String是自定義格式,在關聯車場中唯一equip_name設備名稱String是type_class平臺設備類型String是參見<B.6.1.1平臺設備類型>father_id父級設備IDString是父級設備ID,若無父則使用NULLdelete_flag設備狀態Boolean是描述該設備信息是否已刪除(true:已刪除;false:未刪除),默認值falsepark_id關聯車場IDString是參見<B.3.1車場信息的item_id,如果是車場設備,提供parkId>timestamp時間戳Long是時間戳,每更新一次都需要更新channel_no通道號是io_type出入口類型是參見<B.6.1.30出入口類型>T/QME0015-2024返回值:JSON格式字符串屬性名稱類型長度必須說明result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否item_idString是與請求參數相同error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗error_message業務處理返回信息String否設備狀態信息上傳B.3.1.8接口協議描述:停車場系統調用青島智慧停車一體化平臺接口主動推送車場設備狀態信息,每1分鐘上傳一次。頻率:1分鐘一次,無論設備狀態是否有變化,上傳失敗無須重傳。請求url:http://serverUrl/thirdAPI/equipstatus場景:靜態碼支付業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明equipment_idString是記錄ID(全球唯一標識32位Guid)equipment_state設備狀態String是參見<B.6.1.2設備狀態>timestamp時間戳Long是時間戳,每更新一次都需要更新返回值:JSON格式字符串屬性名稱類型長度必須說明result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否equipment_idString是與請求參數相同error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗error_message業務處理返回信息String否套餐信息上傳T/QME0015-2024B.3.1.9接口協議描述:停車場系統調用青島智慧停車一體化平臺接口主動推送套餐信息,停車場系統定制的共享停車套餐(包月共享、包次共享)通過此接口上傳至平臺,供車主購買共享服務,每24小時內全部套餐信息上傳一次,上傳失敗支持重傳。頻率:24小時一次,無論套餐信息是否有變化。請求ur:http://serverUrl/thirdAPI/cardtypeinfo場景:共享及月卡業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明item_idString是記錄ID(全球唯一標識32位Guid)tc_code套餐編號是參見<B.6.1.31套餐編號>tc_name套餐名稱String是seal_type套餐大類是1:月租車,2:臨時車,3:免費車,4:預付費車service_type服務類型String是參見<B.6.1.3服務類型>tc_type套餐類型String是參見<B.6.1.22車場卡類型>delete_flag卡狀態Boolean是描述該卡類型信息是否已刪除(true:start_period開始時間String否如07:20,共享停車使用end_period結束時間String否如20:40,共享停車使用week星期信息Object否Json字符串,參見<B.6.1.21星期信息>,共享停車使用attach附加信息Object否JSON字符串,作為擴充字段,見如下attach定義,共享停車使用timestamp時間戳Long是時間戳,每更新一次都需要更新attach定義如下屬性名稱類型長度必須說明count允許通行次數是返回值:JSON格式字符串屬性名稱類型長度必須說明T/QME0015-2024result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否item_idString是與請求參數相同error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗error_message業務處理返回信息String否車場月收費標準上傳B.3.1.10接口協議描述:停車場系統調用青島智慧停車一體化平臺接口主動推送車場月收費標準信息,通過此接口與【套餐信息上傳】相結合,展示車場的包月停車和共享停車的收費金額,供車主購買服務,每24小時內上傳一次,上傳失敗支持重傳。其中的【時間】字段代表此套餐可使用多長時間,例如:季卡套餐,此數為3,半年卡套餐,此數為6......頻率:24小時一次,無論收費標準是否有變化。請求url:http://serverUrl/thirdAPI/monthstandardinfo場景:共享及月卡業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明item_id車場月卡收費標String是記錄ID(全球唯一標識32位Guid)month_period是時間(單位月)month_period_money收費金額Decimal(12,2)是保留兩位小數(單位:元)tc_idString是參見<B.3.10套餐信息上傳item_id>delete_flag月收費標準狀態Boolean是描述該月卡收費標準是否已刪除(true:已刪除;false:未刪除默認值falsetimestamp時間戳Long是時間戳,每更新一次都需要更新返回值:JSON格式字符串屬性名稱類型長度必須說明T/QME0015-2024result_code業務接收返回碼是0:接收成功1:接收失敗message返回信息String否item_id車場月收費標準IDString是與請求參數相同error_code業務處理返回碼否0:業務數據處理成功1:業務數據處理失敗error_message業務處理返回信息String否無感車牌反查B.3.1.11接口協議描述:入場記錄上報后,若停車場免費停車時間內或車輛出場時未下發無感車牌通知,則運營商場站應在車輛出場前調用此接口,主動查詢該車輛是否為無感車牌,若返回車輛支持無感支付,則出口識別到該車牌號時,道閘應調用【發起主動扣款請求】進行扣款請求,請求失敗支持重傳。請求url:http://serverUrl/thirdAPI/cloud/querySignatoryResult場景:無感支付業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明car_no車牌號碼String是vehicle_info車輛信息String是參見<B.6.1.29車輛基礎信息>in_time入場時間String是時間格式:yyyy-MM-ddHH:mm:ssin_recordid入場記錄IDLong是返回值:JSON格式字符串屬性名稱類型必須說明result_code業務接收返回碼是0:成功1:失敗message返回信息String否user_idAPP用戶IdString是car_no車牌號碼String是vehicle_info車輛信息String否參見<B.6.1.29車輛基礎信息>in_recordid入場記錄IDString否is_signatory車輛是否開通無感標識是0:未開通1:開通無感withhold_mode無感支付模式是0:先出后扣T/QME0015-20241:先扣后出withhold_channel無感扣款渠道String否withhold_limit無感支付最高額度Decimal(12,2)否單位:元withhold_balance開通無感時的賬戶余額Decimal(12,2)否單位:元signatory_code業務驗簽編碼是1000:驗簽成功1001:驗簽參數為空1002:驗簽參數不是標準JSON1003:驗簽數據為空1004:車場未開通無感支付1005:車場未配置無感扣款渠道1006:車場存在未支付訂單1007:車輛未簽約無感1008:車場支持的代扣方式中不包含渠道商的代扣方式1009:云平臺渠道商驗簽URL未配置1010:云平臺渠道商驗簽beanId未配置1011:云平臺渠道商驗簽beanId配置錯誤1012:云平臺渠道商驗簽成功is_enable_etc是否支持ETC否0:否(默認)1:是attach附加信息String否JSON字符串發起主動扣款請求B.3.1.12接口協議描述:車主同青島智慧停車一體化平臺簽約,開通無感支付,支持先扣后出,在出口識別到車牌后,車場系統需要發起扣款請求,請求平臺進行扣款,請求失敗支持重傳。請求url:http://serverUrl/thirdAPI/cloud/dkOrderRequest場景:無感支付業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明order_no訂單號String是park_code車場編號String是car_no物理卡號、車牌號、虛擬憑證號碼String是T/QME0015-2024vehicle_info車輛信息Object是參見<B.6.1.29車輛基礎信息>service_stime計費開始時間String是時間格式:yyyy-MM-ddHH:mm:ssservice_etime計費結束時間String是時間格式:yyyy-MM-ddHH:mm:ssservice_fee_time計費總時間是單位:秒service_fee原始計費總金額是單位:分deduct_fee扣減金額否單位:分discount_fee優惠金額否單位:分transport_fee物流金額否單位:分other_fee其他金額否單位:分total_fee實際需要支付的金額是單位:分create_time訂單生成時間String是時間格式:yyyy-MM-ddHH:mm:ssfree_minute免費分鐘數String是超時允許滯留分鐘數surplus_minute剩余免費分鐘數String否正常訂單為入場后到現在還剩下的免費分鐘數,超時訂單為上一次繳費后到現在剩下的超時允許滯留分鐘數policy_minute打折減免時間否訂單總共減免的分鐘數charge_type收費類型是0:正常收費1:超時收費2:其他類型desc交易備注String否serial_no流水編號String否out_equip_code出口設備編號String是返回值:JSON格式字符串屬性名稱類型必須說明result_code業務接收返回碼是0:成功1:失敗message返回信息String否T/QME0015-2024order_no訂單號String是status訂單狀態String是訂單狀態:-1:未支付1:支付失敗100:支付成功300:已退款500:交易關閉(在第三方支付已關閉訂單)create_time訂單創建時間String是時間格式:yyyy-MM-ddpay_time付款時間String是時間格式:yyyy-MM-ddtransaction_id第三方支付交易IDString否pay_type付款方式String是參見<B.6.1.11付款方式>訂單支付結果反查B.3.1.13接口協議描述:車主支付成功通知后,由青島智慧停車一體化平臺下發成功通知給停車場系統。當道閘軟件識別到車牌,彈出停車訂單信息后,為防止支付成功通知下發失敗,停車場系統可以通過此接口主動調用訂單支付結果,如果已支付,理應主動開閘放行,請求失敗支持重傳。請求url:http://serverUrl/thirdAPI/cloud/queryOrderStateRequest場景:支付業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明order_no訂單號String是park_code車場編號String是返回值:JSON格式字符串屬性名稱類型必須說明result_code業務接收返回碼是0:成功1:失敗message返回信息String否order_no訂單號String是status訂單狀態String是訂單狀態:-1:未支付0:交易成功(與100同等含義)T/QME0015-20241:支付失敗100:支付成功300:已退款500:交易關閉(在第三方支付已關閉訂單)status=0或100時,如下字段必填pay_time付款時間String是transaction_id第三方支付交易IDString是pay_type付款方式String是參見<B.6.1.11付款方式>pay_from支付來源String是"第三方"bank_type付款方式中文描述String是payType中文描述,如微信、支付寶total_fee用戶實際支付金額是單位:分create_time訂單創建時間String是車位狀態信息上傳B.3.1.14接口協議描述:車輛駛入車位后,停車場識別到車位狀態發生改變,將狀態信息及停入車輛信息上傳平臺,請求失敗支持重傳。請求:http://serverUrl/thirdAPI/cloud/place/status場景:車位狀態更新業務參數p(parameter):JSON格式字符串屬性名稱類型長度必須說明item_idString是code車位編號String是area車位所在區域String否park_name停車場名稱String是項目名稱park_code停車場編號String是項目編號floor車位所在樓層String否book_flag是否可預定String否0:不可預定1:可預訂car_no車牌號碼String是車牌號碼reco_time識別時間String是時間格式為:yyyy-MM-ddT/QME0015-2024place_type車位類型String是0:臨時1:長租2:已售place_status車位空閑狀態String是0:空閑1:已預定2:已占用status車位狀態String是NORMAL:正常DELETED:刪除park_idString是返回值:JSON格式字符串屬性名稱類型長度必須說明result_code返回碼是0:成功1:失敗message返回信息String否data_items返回結果集String否item_id記錄唯一標識String是data_items不為空時必填code業務數據返回碼是data_items不為空時必填0:成功1:失敗B.4下行業務接口協議月卡開通、延期、變更下發描述:用戶通過平臺購買共享車位訂單或月卡訂單,用戶購買成功后平臺會將月卡信息下發到停車場,購買了月卡的車牌號在有效時間段內進出場直接抬桿放行,在有效時間段內停車不計費。此接口為平臺下發,道閘系統接收到下發的月卡訂單,只需要將車牌號添加到收費系統中即可,有效期為套餐開始時間和套餐結束時間,如果系統中已經存在該車牌號,則更新套餐起止時間,不需要作時間的校驗,平臺在下發時已經進行了套餐有效期的校驗。套餐的開始時間和套餐結束時間為車牌的有效期。場景:共享及月卡Content:JSON格式字符串屬性名稱類型必須說明item_id記錄IDString是guidservice_id服務IDString是operate_type服務操作類型String是參見<B.6.1.18服務操作類T/QME0015-2024region_id_list區域ID數組Object[]是全量處理seal_id套餐IDString是place_num車位數是start_time服務開始時間String是end_time服務結束時間String是month延期月份數否money實收金額Decimal(12,2)否ys_money應收金額Decimal(12,2)否refundys_money應退金額Decimal(12,2)否refundss_money實退金額Decimal(12,2)否start_calc_date本延期開始時間String否pay_type付款方式String否參見<B.6.1.9付款方式>person_id人員IDString是人員信息Object否月卡開通時必傳person_infoitem_idcodenameid_card_typeid_card_noagetelephone人員編號人員名稱證件類型證件編號性別年齡電話號碼String是String是String是String否參見<B.6.1.5證件類型>String否String否參見<B.6.1.4性別類型>否String否憑證車輛信息列表Object[]否json,月卡開通時必傳credentialcard_idcredential_typecredential_nocar_idstatusvehicle_info憑證類型憑證編號憑證狀態車輛信息String是是參見<B.6.1.12卡介質類String是String是String是參見<B.6.1.20卡狀態>Object是參見<B.6.1.29車輛基礎信T/QME0015-2024timestamp時間戳Long是記錄操作時間(13位)返回值:JSON格式字符串屬性名稱類型必須說明result_code返回碼是0:業務成功1:業務失敗message返回消息String否錯誤信息cmd_type業務類型String是和請求參數的cmd_type保持一致seq_id請求IDString是和請求參數里的seq_id一致data_items業務集合String否error_code業務響應編號是0:業務成功1:業務失敗error_message業務響應描述String否item_id記錄IDString是月卡注銷描述:用戶購買月卡后,在滿足退款條件下可以取消訂單并退款,用戶退款后平臺會將用戶取消訂單的消息下發給停車場,注銷對應的月卡信息。道閘系統接收到月卡注銷訂單狀態的信息后,直接刪除該車牌對應的固定車信息即可,不需要更新。如果用戶的車牌有效期修改,會通過【月卡開通、延期、變更下發】接口下發,按照前文接口描述,道閘系統收到相應信息后更新有效期即可。場景:共享及月卡Content:JSON格式字符串屬性名稱類型必須說明item_id記錄IDString是guidservice_id服務IDString是timestamp時間戳Long是記錄操作時間(13位)返回值:JSON格式字符串屬性名稱類型必須說明result_code返回碼是0:業務成功1:業務失敗message返回消息String否錯誤信息T/QME0015-2024cmd_type業務類型String是和請求參數的cmd_type保持一致seq_id請求IDString是和請求參數里的seq_id一致data_items業務集合String否error_code業務響應編號是0:業務成功1:業務失敗error_message業務響應描述String否item_id記錄IDString是請求獲取訂單信息描述:青島智慧停車一體化平臺通過車牌號向指定停車場系統查詢車輛的訂單信息。場景:支付Content:JSON格式字符串屬性名稱類型必須說明partner商戶號String是商戶號,用戶對賬car_no車牌號碼String是vehicle_info車輛信息Object是參見<B.6.1.29車輛基礎信息>timestamp時間戳是返回值:JSON格式字符串屬性名稱類型必須說明result_code返回碼是0:業務成功1:業務失敗message返回消息String否錯誤信息seq_id請求IDString是和請求參數里的seq_id一致cmd_type業務類型String是data_items業務集合String否error_code業務響應編號是0:業務成功1:業務失敗2:未入場5:非臨時卡T/QME0015-20249:超時滯留時間內10:正常免費時間內error_message業務響應描述String否partner商戶號String是car_location車位String是一般是空值invoice_receiving_place發票領取處String是可為空值overtime_charge_flag超時收費標記String是0:否,1:是charge_standard_desc收費標準描述String是mer_gid卡號String是填車牌號碼car_no車牌號碼String是park_code項目編號String是由青島智慧停車一體化平臺統一下發,其他接口中的項目編號一致park_idString是park_name車場名稱String是out_trade_no訂單號String是service_stime計費開始時間String是yyyy-MM-ddHH:mm:ssservice_etime計費結束時間String是yyyy-MM-ddHH:mm:ssservice_fee_time計費時長Long是單位:秒goods_title商品標題String是停車費service_fee應收金額是單位:分discount_fee優惠金額否單位:分total_fee實收金額是單位:分free_minute免費分鐘數是繳費后允許停留的時間,單位:分鐘surplus_minute剩余免費分鐘數否進場后,剩余的免費分鐘數,單位:分鐘serial_no流水號String是一次進出使用一個編號,整個系統唯一線上支付成功通知下發描述:用戶通過移動端支付、掃碼付、無感支付等多種支付方式支付費用成功后,青島智慧停車一體化平臺下發線上支付成功通知到停車場系統,車場收到通知后,開閘放行。當道閘軟件識別到車牌,彈出停車訂單信息后,為防止支付成功通知下發失敗,停車場系統可主動調用【訂單支付結果反查】接口,多次輪詢查詢訂單支付情況。場景:支付Content:JSON格式字符串T/QME0015-2024屬性名稱類型必須說明trad_state支付結果是0:成功pay_info支付結果信息String否支付成功時,為空pay_type支付方式String否參見<B.6.1.9付款方式>pay_from支付來源String否如:"支付寶"、"微信"、"錢包"、"第三方"total_fee支付金額是單位:分fee_type支付幣種是1:人民幣,默認值:1out_trade_no訂單號String是time_end支付時間String是返回值:JSON格式字符串屬性名稱類型必須說明result_code返回碼是message返回消息String否錯誤信息seq_id請求IDString是和請求參數里的seq_id一致cmd_type業務類型String是無感車牌通知下發描述:車輛入場,停車場系統上報入場記錄之后,青島智慧停車一體化平臺將無感車輛檢驗結果下發給停車場系統,若車輛支持無感支付,則車輛出場時停車場系統主動調用【發起主動扣款請求】接口,進行扣款處理,若停車場免費停車時間內或車輛出場前平臺未下發無感車牌通知,停車場系統主動調用【無感車牌反查】接口,
溫馨提示
- 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯系上傳者。文件的所有權益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網頁內容里面會有圖紙預覽,若沒有圖紙預覽就沒有圖紙。
- 4. 未經權益所有人同意不得將文件中的內容挪作商業或盈利用途。
- 5. 人人文庫網僅提供信息存儲空間,僅對用戶上傳內容的表現方式做保護處理,對用戶上傳分享的文檔內容本身不做任何修改或編輯,并不能對任何下載內容負責。
- 6. 下載文件中如有侵權或不適當內容,請與我們聯系,我們立即糾正。
- 7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- 全球寵物市場洞察之泰國篇:本土與出口市場雙擴張中國品牌布局正啟航402mb
- 彌漫性食管痙攣的臨床護理
- 2025年門診部年度工作總結模版
- 角弓反張的臨床護理
- 暑期招生美術培訓方案大綱
- 圓錐曲線公式總結模版
- 高血壓防治與管理要點
- 四川省成都市溫江區第二區2025年數學七下期末質量跟蹤監視模擬試題含解析
- 護膚培訓年終工作總結與展望
- 抗菌藥物培訓考核試題及答案
- 2025年陜西省八年級中考三模生物試題(原卷版+解析版)
- 高分子化學材料結構與性能試題及答案
- 特種設備操作人員培訓管理制度
- 客服質檢管理競聘述職報告
- 2025年湖北省孝感市中考物理模擬試卷(3月份)(含解析)
- 2024年四年級英語下冊 Module 4 Things we enjoy Unit 12 The ugly duckling第1課時教學實錄 牛津滬教版(三起)
- 2025年煤化工主要設備一覽及工作原理等分析
- ICU醫院感染暴發應急處置演練方案
- 中外教育史知到課后答案智慧樹章節測試答案2025年春泰山學院
- 基礎有機化學實驗知到智慧樹章節測試課后答案2024年秋浙江大學
- 特種設備安全管理的法律法規遵守培訓計劃
評論
0/150
提交評論