路侧停车场系统接口规范

路侧停车场系统

接口规范

(V1.0.0)

版本历史

版本拟稿和修改日期备注

1.0.0杨德斌2019/9/20初稿

目录

1引言错误!未定义书签。

1.1概述错误!未定义书签。

1.2适合范围错误!未定义书签。

1.3术语和定义错误!未定义书签。

2接入方式错误!未定义书签。

2.1HTTP接入错误!未定义书签。

2.2HTTP响应错误!未定义书签。

3安全规范错误!未定义书签。

3.1签名机制错误!未定义书签。

4接口说明错误!未定义书签。

4.1查询客户接口说明错误!未定义书签。

4.1.1符号定义错误!未定义书签。

4.1.2请求参数说明错误!木定义书签。

4.1.3请求示例错误!未定义书签。

4.1.4返回参数说明错误!未定义书签。

4.2登录接口说明错误!未定义书签。

4.2.1符号定义错误!未定义书签。

4.2.2请求参数说明错误!未定义书签。

4.2.3请求示例错误!未定义书签。

4.2.4返回参数说明错误!未定义书签。

4.3进场接口说明错误!未定义书签。

4.3.1符号定义错误!未定义书签。

4.3.2请求参数说明错误!未定义书签。

4.3.3请求示例错误!未定义书签。

4.3.4返回参数说明错误!未定义书签。

4.4查询在场记录接口说明错误!未定义书签。

4.4.1符号定义错误!未定义书签。

4.4.2请求参数说明错误!未定义书签。

4.4.3请求示例错误!未定义书签。

4.4.4返回参数说明错误!未定义书签。

4.5通过车牌查询在场记录接口说明错误!未定义书签。

4.5.1符号定义错误!未定义书签。

4.5.2请求参数说明错误!未定义书签。

4.5.3请求示例错误!未定义书签。

4.5.4返回参数说明错误!未定义书签。

4.6计算金额接口说明错误!未定义书签。

4.6.1符号定义错误!未定义书签。

4.6.2请求参数说明错误!未定义书签。

4.6.3请求示例错误!未定义书签。

4.15.3请求示例错误!未定义书签。

4.15.4返回参数说明错误!未定义书签。

4.16插入黑名单接口说明错误!未定义书签。

4.16.1符号定义错误!未定义书签。

4.16.2请求参数说明错误!未定义书签。

4.16.3请求示例错误!未定义书签。

4.16.4返回参数说明错误!未定义书签。

4.17心跳接口说明错误!未定义书签。

4.17.1符号定义错误!未定义书签。

4.17.2请求参数说明错误!未定义书签。

4.17.3请求示例错误!未定义书签。

4.17.4返回参数说明错误!未定义书签。

4.18MQ状态接口说明错误!未定义书签。

4.18.1符号定义错误!未定义书签。

4.18.2请求参数说明错误!未定义书签。

4.18.3请求示例错误!未定义书签。

4.18.4返回参数说明错误!未定义书签。

4.19查询己经预付接口说明错误!未定义书签。

4.19.1符号定义错误!未定义书签。

4.19.2请求参数说明错误!未定义书签。

4.19.3请求示例错误!未定义书签。

4.19.4返回参数说明错误!未定义书签。

4.20查询欠费接口说明错误!未定义书签。

4.20.1符号定义错误!未定义书签。

4.20.2请求参数说明错误!未定义书签。

4.20.3请求示例错误!未定义书签。

4.20.4返回参数说明错误!未定义书签。

4.21查询历史接口说明错误!未定义书签。

4.21.1符号定义错误!未定义书签。

4.21.2请求参数说明错误!未定义书签。

4.21.3请求示例错误!未定义书签。

4.21.4返回参数说明错误!未定义书签。

4.22获取月卡接口说明错误!未定义书签。

4.22.1符号定义错误!未定义书签。

4.22.2请求参数说明错误!未定义书签。

4.22.3请求示例错误!未定义书签。

4.22.4返回参数说明错误!未定义书签。

4.23获取参数接口说明错误!未定义书签。

4.23.1符号定义错误!未定义书签。

4.23.2请求参数说明错误!未定义书签。

4.23.3请求示例错误!未定义书签。

4.23.4返回参数说明错误!未定义书签。

4.24月卡续费接口说明错误!未定义书签。

4.24.1符号定义错误!未定义书签。

4.24.2请求参数说明错误!未定义书签。

4.24.3请求示例错误!未定义书签。

4.24.4返回参数说明错误!未定义书签。

4.25获取图片接口说明错误!未定义书签。

4.25.1符号定义错误!未定义书签。

4.25.2请求参数说明错误!未定义书签。

4.25.3请求示例错误!未定义书签。

4.25.4返回参数说明错误!未定义书签。

4.26无感车牌查询接口说明错误!未定义书签。

4.26.1符号定义错误!未定义书签。

4.26.2请求参数说明错误!未定义书签。

4.26.3请求示例错误!未定义书签。

4.26.4返回参数说明错误!未定义书签。

4.27无感支付接口说明错误!未定义书签。

4.27.1符号定义错误!未定义书签。

4.27.2请求参数说明错误!未定义书签。

4.27.3请求示例错误!未定义书签。

4.27.4返回参数说明错误!未定义书签。

4.28根据客户ID获取该客户所有场库接口说明错误!未定义书签。

4.28.1符号定义错误!未定义书签。

4.28.2请求参数说明错误!未定义书签。

4.28.3请求示例错误!未定义书签。

4.28.4返回参数说明错误!未定义书签。

4.29查询欠费历史接口说明错误!未定义书签。

4.29.1符号定义错误!未定义书签。

4.29.2请求参数说明错误!未定义书签。

4.29.3请求示例错误!未定义书签。

4.29.4返回参数说明错误!未定义书签。

4.30通过车牌查询月卡接口说明错误!未定义书签。

4.30.1符号定义错误!未定义书签。

4.30.2请求参数说明错误!未定义书签。

4.30.3请求示例错误!未定义书签。

4.30.4返回参数说明错误!未定义书签。

4.31开票接口说明错误!未定义书签。

4.31.1符号定义错误!未定义书签。

4.31.2请求参数说明错误!未定义书签。

4.31.3请求示例错误!未定义书签。

4.31.4返回参数说明错误!未定义书签。

5附录错误!未定义书签。

5.1MQTT通知数据格式错误!未定义书签。

5.2系统代码定义错误!未定义书签。

1引言

L1概述

路侧停车场系统接口规范。

L2适合范围

路侧停车场系统。

1.3术语和定义

1.JSON：JSON（JavsScriptObjectNotation）是一种轻量级的数据交换格式，采用完全

独立于语言的文本格式，是理想的数据交换格式。

2.系统涉及的时间全部采用时间戳（Unix时间戳）

3.系统涉及到金额全部用采用元为单位

2接入方式

2.1HTTP接入

采用HTTP标准的POST协议进行传输。

2.2HTTP响应

1.响应格式：json明文

2.示例：

{"fStatus":1,"fResponseMessage":""/"fResponseTime":z"fData":{}}

fStatus：1表示成功0表示失败（其他值待定）

fResponseMessage：失败时返回信息

fResponseTime：返回时间戳

fData：接口返回的数据

3安全规范

3.1签名机制

对于报文的签名处理机制如下：

签名机制是报文发送方使用•定的加密校验机制对报文体内容进行签名，保证报文的合

法性和防止篡改。签名使用的key需要找相关开发人员获取.

1.请求参数格式必须是：

{"parm":,,ewoiZklldGhvZCI6lkFwcF9RdWVyeUNlc3QiLAoiZkRldlR5cGVJRCI6ljAiLAoiZkNl

c3RObyl6ljUxOTk5OSIKfQ=="；,sign":"46B39423AA796A43F2A72AF4"}

2.parm参数说明：把json的内容采用utf8转成base64

示例：

原文：{"fMethod”:“App_QuoryCust"JfDevTypelD"：5"fCustNo”"19999”}

采用utf8转成Base64：

ewoiZklldGhvZCI6lkFwcF9RdWVyeUNlc3QiLAoiZkRldlR5cGVJRCI6ljAiLAoiZkNlc3RObyl6l

jUxOTk5OSIKfQ==

3.sign参数说明：parm的原文采用md5计算签名并转成大写

示例：{"fMethod":"App_QueryCust,,；,fDevTypelD":"0"；'fCustNo,,:"519999"}^^Md5

后的值:46B39423AA796A43F2A72AF4

4接口说明

4.1查询客户接口说明

4.1.1符号定义

fMethod表示需要调用的接口。

fDevTypelD表示设备类型。

fCustNo云平台客户编号。

4.1.2请求参数说明

属性数据类型描述取值备注

fMethodString接口名App_QueryCust必填

0手持机1视频住

fDevTypelDString设备类型必填

2高位球

fCustNoString客户编号必填

4.1.3请求示例

NofnvvwmenK

http*'.^©€>f>aicl22O6/«pv«r；•*onhsp/3oc»tvKl220^api»RSP^•••••

http://k>calbott：12206/ap4/RSPAPUWSPCM

POST▼hap7Aoc4ibo«E1220&«pM*R$PAPVY6t>Qll

•none•^xnvdM*'x-4MW^4onrHx49«xod«d•，r*•，rwyJ$Oi(appfecflCiQfVjwn)▼

1ro*f^rlWlZUlad*vZCX61icF-cFdMWW$tatlcJQiLO^e^lw2U16IjoKIl!«3>dJlMeT«810iIlHTi^OTicl^ZiSgA-：-»3736aK6K64D474^MK12SllTiAS")

•200OKTineS22Cm»Stte121KB

2"<Sutws*:L

)■<^e»pcfls«*<e1»•««•：•，

4-*ttipo<ii«TU«-：156sx223.

s-・atv；(

6・•JU"。•：(

,KustW:、812芳82g7“53BM・，

8-fOpLattTiw*:rsdm、

9-*OpOierlO's•10,

1••Ku«tT>ptW:"：•,

Il•j"：rww.

•«“tj•:格1*澳8户，

13-Rfe•:FeaPvM•毫/停，

14—PC8f»V：•••,

*5-*StanOate":"&

ICF2D«tc・；•••,1

17

18•HsHolldty-：•«-»

iormtex•:•••,

24-acUcCvr-i*♦",

21•fFlc$vrO»y»*s・•*.

n-ns»s.r•：・e・.

“rm••:",

24、•.

25•n»sr：0-：Tt

26r&Me"七•8-.

n-fiiiwn'；"«•,

2SyLlWW：r”，，

w.f®e<«re：w.

4.1.4返回参数说明

说明请参照数据库字段说明

{

"fStatus":1,

''IResponseMessage":"',

"fResponseTime":,

"fData":{

"Custlnfo":{

"fCustID":"453888",

"fOpLastTime":"",

"fOpUserlD":T,

"fCustTypelD":T,

"fCustNo":"519999",

"fCustName":"路侧测试客户”,

"fSoftNamc":"RcdParking停车软件”,

"fParkCount1:“0"，

"fStartDate":

"fEndDatc":"0",

"iFeeM:"0.00”，

"flsHoliday":"0",

"OsWeekEnd":"0';

"flsPicSvr":"0",

"fPicSvrDays":“0"，

"flsDBSvr":"0",

"flsSyncData":"0"，

"fGrpID":"2",

"fUsrlD":T,

"fAddress":"dd';

"fLinkman":"abc",

"tLinkPhone":”1235”，

"fRemark":'dd",

"flsNef:T

},

"CustScttinglnfo":{

"fCustID":"453888”,

"fOpLastTime":

"fOpUserlD":T,

"fDBIPAddr":

"tDBPori":"0",

"fDBNamc":

"fDBUser":

"IDBUserPwd":

"fWcblPAdcrl":H:12206/api/RSRARI/RSRCall';

"fWebIPAdcr2":":12206/api/RSPAPI/RSPCall';

"fPayIPAddrr':

"fPayIPAddr2":

"AmglPAddrl":

"flmgIPAddr2":""，

"fLoglPAddrl":

"fLogIPAddr2":

"felnvIPAddrl":

"feInvIPAddr2":

MfUpCurTimes":“30"，

"fUpHisTimes":"91",

"fStartUpTime":

"(MqlllPAddrl":"90"

I

}

)

4.2登录接口说明

4.2.1符号定义

fMethod表示需要调用的接口。

fDevTypoID表示设备类型。

fCustNo云平台客户编号。

fCustID云平台客户ID

fDevAccNo登录编号

fDevAccPwd登录密码

fVersion客户端版本

4.2.2请求参数说明

属性数据类型描述取值备注

fMethodString接口名App_Login必填

0手持机1视频住

fDevTypelDString设备类型必填

2高位球

fCustNoString客户编号必填

fCustIDString客户ID必填

fDevAccNoString登录账号必填

fDevAccPwdString登录密码必填

fVersionString客户端版本号必填

4.2.3请求示例

{“fUethod":"Appjogin","fDevTypelD":"0〃，"fCustN。"："519999〃，“fCustID":"45388

8","fDcvAccNo":"123456","fDevAccPwd":"123456","fVcrsion":"l.0"}

2

3Fesmee””•：•*,

4•flopcwMTiw-：

5・"H:{

6"CETMc,:号可用"!),”"“？.,

7**】3：(

8"/OevAccW:RS0393n

9-fCpcastTlw-：

i・.fopu♦nr：

n•«««»•：・“1293C726)W・

12-519W,

13・”3i

14-f0e/Ac<ito-：-UM56-,

15.QvyZtf-：-W1M2U0SO9fMecseoce、

14

17♦":

IS•标八yxSf,

19”,

21.eet«e«d-：

22-fArtTtm-：rxmmtr.

2)-rS?«tv»*：-r,

24.gfVl-»Me

»》•

»*―"Id•~•：(

”・<

»"<P«rtdio-：・222，

»"*Cowr»/Wi

»1•"...・■»»・・F、、«­，»，»•*«・

0LMTHBrowse

4.2.4返回参数说明

说明请参照数据库字段说明，除〃App_QueryCust"接口和"App,ogin”接口，其他接口都要

传fAccessToken的值

"fStatus":1,

"fResponseMessage":

"fResponseTime":,

"fData":{

"fAccessToken":"086592",

"Devlnfo":{

"fDevAccID":"086592",

"fOpLastTime":

"fOpUserlD":"1",

"fCustID":"453888",

"fCustNo":"519999",

"fParkID":"907712",

"fDevAccNo':"123456",

"fDevAccPwd"："B2CF180285D3D78E1D3969FA70C36DC6",

"fLinkman":

"fLinkPhone":

"fDevTypelD":"O'；

"fPlaceList":"001",

"fDateBeg":“'，

"fDateEnd":

"fActTime":

"fStatus":"!',

"fRemark":"aaa"

},

"Parkinfo":{

"fParkID":"907712",

"fParkNo":"222",

"fCompanylD":"0"z

"fCustlD":"453888",

"fCustNo":"519999",

"fOpLastTime":

"fOpUserlD":"1",

♦ParkName":"路侧场库，

"fParkTypelD":"310",

"fProvincelD":"0",

"fCitylD":"0",

"fDistID":"0\

“fAddress”:"北京市丰台区，

"fLinkman":"3213",

"fLinkPhone":"31233”,

"fParkCount":"32，

"fFreeCount":“32”，

"fResCount":"0",

"flsSysData":"0",

"(Longitude":"116.321",

"fLatitude":"39.8984",

"fHigh":"0",

"fMapSvrID":"1"

},

,,ParkParamlnfo":{

"10030":"0",

"10170":"3C”,

"10180":"900",

"10320":"09:00",

"10330":":00"

},

"PayParamlnfo":{

"710G0":"0",

"71190":"0",

"72070":"0"f

"73050":"0",

"74001":"333",

"74002":"666",

"74010":"111",

"74020":"55",

"74030":“222”，

"74040"：“444”，

"74060":"1",

"75080":"0",

"99160":"0"

},

"ParkPlaceDataList":[

(

"fBigRowID":

"fOpLastTime":

"fOpUserlD":"1",

"fCustlD":"453888",

"fCustNo":"519999",

"fParklD":"907712",

"fAreaName":"001区域，

"fPlaceNo":"002”，

"fPlateCode":

"fRemark":"002"

},

"fBigRowID":"225984",

"fOpLastTime":

"fOpUserlD":T',

"fCustID":"453888",

"fCustNo":"519999",

"fParkID":"907712",

"fAreaName":"001区域”,

"fPlaceNo":"001",

"fPlateCode":"沪A123456",

"fRemark":"001"

)

1

)

)

4.3进场接口说明

4.3.1符号定义

请参考”4.3.2请求参数说明”。

4.3.2请求参数说明

属性数据类型描述取值备注

fMethodString接口名App_lnPark必填

0手持机1视频柱

fDevTypelDString设备类型必填

2高位球’

fCustNoString客户编号必填

fCustIDString客户ID必填

flnPlateString进场车牌必填

flnParklDString进场场库ID必填

fAccessTokenString访问标识必埴

fCustNameString客户名称必填

fCarNumberString车位号必填

fParkNameString停车场名称必填

fParkNoString停车场编号必填

fPlateColorString车糊颜色必埴

flnRcmarkString入场备注必填

flnConfidenceint进场车牌可信度

flnPicUrlString入场车辆URL

flnPicFileString入场文彳牛名

flnPlateUrlString入场车牌URL

flnPlateFileString文件名

4.3.3请求示例

{"fMelhod":"App」nPark","H)evType[D":"0","fCuslNo":"519999","fCuslID”<453888”,"门nPlale

":"沪A123456","fInParkID":"907712","fAccessToken":"086592","fCustName":"客户名称

","fCarNumbcr":"001","fParkNamc":“路侧场库"，"fParkN。"："222","fPlateColor":"茂色

”,*fInRemark*:**}

E"19Z18Q.2:12206/〜RSWimSPOII

Send

•nor>«•forHMlMa•x-www-4o<m-wl«ncoMd•fM»•tmaryjSOH(«p^McM>cn/)eof*i,

MAMOCKTbw•«SIM1(M<9仅・rloerf

・Q

•Htatvf:1.

"f9<apon»e^»t・・,

F・3“T♦•:1如9E«，，

<

"IrPerf:(

,FrtW：272M0?：X«MM443.

・♦”KW:

*aChnlT«p»a:•.

・♦CTh:♦.

•KWTjPtlO-：e,

•4*MS••:•,

-flnTUe-：•,

•«Chec«Y■•:♦.

•eync♦•:。・

-*Cu»tMW：-VPKIt*.

•””'Jr-MMSIK-.

5•t—•:•加Mi・.l

•reut••:•加1214k.

ywr*•:，

-K«nw*e*-iE・,

-G»Arr-：0.

・“0A,••

4.3.4返回参数说明

说明“inParklnf。”表示进场数据，“cardlnf。”表示月卡信息，“arrearList”表示欠费集

合（所包含的内容跟“inParklnf。”一致）.其他请参照数据库字段说明

"fStatus":1,

"fResponseMessage":

"fResponseTime":,

"fData":{

"inParkinfo":{

"fBusID":554432,

"flnParklD":907712,

"flnChnllD":713407,

"nChnIType":0,

"fCardID":0,

"fCardTypelD":0,

"flsCard":0,Z/l表示月卡

"nlsHide":0,

"flnTime":0,

"fOutTime":Oz

"nCheckTime":0,

"fConfidence":0,

“fCustName":"客户名称”，

"fParkName":"路侧场库”，

"fPlateCode":"沪A123456",

"flnPlate":"沪A123456",

"flnRemark":

"fCarNumber":"001",

"flsArr":0,

"flnPicUrl":

"flnPicFile":

"flnPlateUrl":

"flnPlateFile":

"fCustlD":453888,

"fCustNo":"519999",

"fOpUserlD":086592,

"fPlateColor":“蓝色”，

"fCarTypelD':0,

"fRateGrouplD":0,

"fCommRatelD":0,

"fHoliRatelD'iO,

"fFreeSecs'^O,

"fBatStartTime":0,

"fBatEndTime":0,

"fPlaceNums":0,

"fUseDays":0,

"flnCamlP":

"flnCamType":""，

"flnCapMode":0

},

"cardinfo":{

"nCardStatus":0,"3表示非月卡1表示月T

"nllseDays":0〃表示剩余天数

},

"arrearList":[]

)

4.4查询在场记录接口说明

4.4.1符号定义

请参考“4.4.2请求参数说明”。

4.4.2请求参数说明

属性