智享停车平台对接协议.doc

《智享停车平台对接协议.doc》由会员分享，可在线阅读，更多相关《智享停车平台对接协议.doc（12页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、智享停车平台对接协议智享停车平台对接协议 序序: 1.平台地址:htpp:/(也可将平台部署到您服务器上建立私有云平台) 2.通讯方式:Http, post, Get 3.提交数据格式:Url string 4.返回数据格式:XML 5.编码格式:utf-8 一一: :添加添加车场编号车场编号生成生成车场车场PkeyPkey二二: :生成会话凭证生成会话凭证TokenToken 例例: :string PostUrl=“http:/ TokenToken = MD5(PostUrl .ToLower() + PkeyPkey .ToLower();/加密字串转换小写后 加密string Pos

2、tUrl= PostUrl +“接口测试地址:http:/ 智享停车平台用户测试账户智享停车平台用户测试账户 2.1运营商测试账户用户名:13418901852密码:123456 2.2车场物业测试账户车场编号:13418901852用户名:888888密码:123456一一: : 心跳接口心跳接口( (事件通知事件通知, ,建议建议1 1到到2 2秒跳一次秒跳一次) )http:/ /App/ getTask.aspx 提交参数提交参数参数名称参数名称数据数据 类型类型长度长度为空为空备注备注ParkNostring11N车场编号Tokenstring128N会话凭证(详情见名词解释)返回参

3、数返回参数参数名称参数名称数据数据 类型类型长度长度为空为空备注备注TaskNamestring11N事件名称(见任务说明表)TaskApistring128N事件回调接口(见任务说明表)TaskKey1string12N第一个关键字Key1Valuestring32N第一个关键字值TaskKey2string12N第二个关键字Key2Valuestring32Y第二个关键字值ReMachIpint4Y现场接收 IP(255.255.255.255 为所有机号)OperTypestring12N Description(“新增“)Add,Description(“删除“)Del,Descrip

4、tion(“修改“)Edit,Description(“充值“)Fill,Description(“延期“)Delay,TaskTimestring16NYyyy-MM-dd HH:mm:ssTaskStatusstring12N任务状态 wait 待处理,ok 已处理事件任务说明表事件任务说明表事件名称事件名称功能说明功能说明事件数据获事件数据获 取接口取接口TaskKey1Key1ValueTaskKey2Key2ValueInCar入场通知/App/getInCar .aspxCarNo粤B12345InTime2018-05- 16 12:20:34WaitOut等待出场通 知/App

5、/getWait Out.aspxCarNo粤B12345OutTime2018-05- 16 12:20:34OutCar开闸出场通 知/App/getOutC ar.aspxCarNo粤 B12345OutTime2018-05- 16 12:20:34MonCar月租变更通 知/App/getMon Car.aspxOrderNo“1234567 8”TaskTime2018-05- 16 12:20:34二：回调接口二：回调接口2.1. 入场通知入场通知_回调接口回调接口http:/http:/ getInCar.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为

6、空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号InTimestring16N入场时间(yyyyMMddHHmmss)Tokenstring128N会话凭证(详情见名词解释)返回参数返回参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring4N错误代码CardNostring12N卡片号码CarNoString12N车牌号码CarTypeString12N车辆类型 A-H(月卡,临时,月临,储值)例如月卡 AInLaneString12N入场车道名In

7、TimeDateTime16N入场时间(yyyy-MM-dd HH:mm:ss)InPicString125N入场图片路劲PayFeestring12N场内缴费金额(元)PayTimeDateTime16N场内缴费时间OutPayFeestring12N场内超时缴费金额(元)OutPayTimestring12N场内超时缴费时间InMachIpstring16N入场机器 Ip2.2. 等待出场通知等待出场通知_回调接口回调接口http:/http:/ getWaitOut.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车

8、场编号CarNostring10N车牌号OutTimestring6N出场时间(yyyyMMddHHmmss)Tokenstring128N会话凭证(详情见名词解释)返回参数返回参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码OutMachIpstring12N车道控制机 IpOutLaneString32N出场车道名称OutTimeString8N出场时间(yyyy-MM-dd HH:mm:ss)OutTypeString12N刷卡 Card,手机号 Phone,扫码 ScanCode,普通牌 CarNo,新能

9、源 NewCar,人脸 Face,证件 ID,指纹 FintOutPicstring255Y出场图片路径CarTypestring12N车辆类型 A-H(月卡,月临,储值)例如月卡 ATicketNostring8N停车卷号PayFeeint8N支付金额(分)2.3. 开闸出场通知开闸出场通知_回调接口回调接口http:/http:/ getOutCar.aspx 提交参数提交参数参数名称参数名称数据类数据类 型型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号OutTimestring14Y出场时间(yyyyMMddHHmmss)Tok

10、enstring128N会话凭证(详情见名词解释)返回参数返回参数参数名称参数名称数据类数据类 型型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码InMachIpstring12N车道控制机 IpInLaneString32N入场车道名称InTimeString14N入场时间(yyyy-MM-dd HH:mm:ss)InPicString255N入场图片路径InTypeString12N入场方式(识别,扫码,手机号,刷卡,手动开闸)InMachIpstring12N车道控制机 IpOutLaneString32N出场车道名称OutMachIpst

11、ring12N出场车道控制机 IpOutLaneString32N出场车道名称OutTimeString14N出场时间(yyyy-MM-dd HH:mm:ss)OutTypeString12N出场方式(识别,扫码,手机号,刷卡,手动开闸)MustFeeint4N应收金额分为单位PayFeeint4N实收金额分为单位OutMachIpstring16N出场机器 Ip2.4.月租车变更通知月租车变更通知_回调接口回调接口http:/ /App/getMonCar.aspx 提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostr

12、ing10N车牌号TaskTimestring14Y事件发生时间(yyyyMMddHHmmss)Tokenstring128N会话凭证(详情见名词解释)返回参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法CardNostring12N卡片号码CarTypestring12N车辆类型UserNostring12N车主编号UserNamestring12N车主姓名StartTimeDateTime8N生效开始时间(yyyy-MM-dd HH:mm:ss)EndTimeDateT

13、ime8N生效结束时间(yyyy-MM-dd HH:mm:ss)MachListstring255N机号列表(68,70,N,)三三:停车支付下单接口停车支付下单接口3.1.临停缴费确认下单接口临停缴费确认下单接口http:/http:/ getTmpFee.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号ParkSizestring6N大小场标识BIG大,Mini小Tokenstring128N会话凭证(详情见名词解释)返回参数返回参数参数名称参数名称数据类型数据类型长度长度为空

14、为空备注备注MsgStrstring64N错误描述ErrNostring4N错误代码WayInfostring64Y错误处理办法OrderNoString64N订单号流水号(加密字符串)PayTimeString64N计费截止时间:yyyy-MM-dd HH:mm:ssMustFeeint4N应收金额分为单位PayFeeint4N实收金额分为单位FeeTypeint8N正常缴费（0）超时补费（1）StopTimeString16N停车时长 N 天 N 时 N 分 N 秒OutTimeString16N缴费到出场允许滞留时间 N 天 N 时 N 分 N 秒TicketNoString8Y停车卷号

15、DistTypeString8Y折扣类型(全免,免时,免钱,多次全免,优惠价)ManageIdint8N入场操作员编号PicPathstring255Y入场图片路劲CarTypestring12N车辆类型 A-H(月卡,月临,储值)例如”临时卡 A”3.2.月租延期下单接口月租延期下单接口http:/ /App/getMonFee.aspx 提交参数参数名称参数名称数据类数据类 型型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号MonCntint4N几个月Tokenstring128N会话凭证(详情见名词解释)返回参数参数名称参数名称数

16、据类型数据类型长长 度度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法OrderNostring32N订单号CarTypestring12N车辆类型UserNostring12N车主编号UserNamestring12N车主姓名StartTimeDateTime8N生效开始时间(yyyy-MM-dd HH:mm:ss)EndTimeDateTime8N生效结束时间(yyyy-MM-dd HH:mm:ss)MonFeeint8N月租费用(分)MonTotalFeeint8N延期总金额(分)CarTypestring1

17、2N车辆类型 A-H(月卡,月临,储值)例如月卡 A3.3.支付通知接口支付通知接口http:/ /App/UpPayNotify.aspx 发送参数发送参数:参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号OrderNostring64N订单编号Tokenstring128N会话凭证(详情见名词解释)PayStatusstring12N状态(Wait 等待,Lost 失败,OK 成功,取消 Cancel)PayType Description(“微信“)WeiXin,Description(“支付宝“)AliPay,Description

18、(“银联“)UnionPay,Description(“现金“)Cash,Description(“预存支付“)AppPay,Description(“支付宝无感付“)AliPayAuto,Description(“微信无感付“)WeiXinAutoDescription(“银联无感付“)UnionAuto,Description(“其他“)Other,PayNostring32N支付平台支付流水号OutTradeNostring32N支付平台下单号返回参数返回参数:参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码W

19、ayInfostring64Y解决办法四四:主动上报接口主动上报接口4.1.月租变更上传接口月租变更上传接口http:/ /App/UpMonCar.aspx 提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号Tokenstring128N会话凭证(详情见名词解释)UserNamestring12N车主姓名 OperTypestring12N Description(“新增“)Add,Description(“删除“)Del,Description(“修改“)Edit,Description(“充值“

20、)Fill,Description(“延期“)Delay,Feestring12N充值延期金额(分)StartTimestring16N新的有效开始时间EndTimestring16N新的有效结束时间CarTypestring12N车辆类型 A-H(月卡,月临,储值)例如月卡 ACardStatusint4N正常使用:0,退卡 OK : 5,Balanceint4N余额(分)MachListstring255N通行机号列表 45_68_70_90_N(ip 地址最后一段以” _”结尾)SetNostring12N车位编号返回参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgSt

21、rstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法4.2.手动放行上传接口手动放行上传接口 http:/ /App/ UpOpenCmd.aspx 提交参数参数名称参数名称数据类数据类 型型长度长度为空为空备注备注ParkNostring12N车场编号车场编号Tokenstring128N会话凭证(详情见名词解释)CarNostring12N车牌号CarTypestring12N车辆类型 A-H(月卡,月临,储值)例如月卡 AMachNostring16N开闸机号(ip 地址最后一段)PayFeestring16Y实收金额(可不传)Memost

22、ring64N放行原因返回参数:参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法五五:主动查询接口主动查询接口5.1.场内车辆列表查询接口场内车辆列表查询接口 http:/ /App/getInCarList.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号Tokenstring128N会话凭证(详情见名词解释)CarNostring12Y车牌号CarTypestring12Y车辆类型 A-H(月卡

23、,月临,储值)例如月卡 AMachNostring16Y开闸机号(ip 地址最后一段)Memostring12Y原因备注StartTimestring16Y入场时开始时间(yyyyMMddHHmmss)EndTimestring16Y入场时结束时间(yyyyMMddHHmmss)PageSizeint4N每页显示记录条数CurPageint4N当前查询页码返回参数返回参数:参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法TotalPageint4N总页数TotalCountin

24、t4N总记录数CarNostring12N车牌号码CarTypestring4N车辆类型 A-H(月卡,月临,储值)例如月卡 AInPicPathstring125N入场图片路径InTimestring16N入场时结束时间(yyyy-MM-dd HH:mm:ss)InMachNostring32N入场控制机号PayTimestring16N场内支付时间(yyyy-MM-dd HH:mm:ss)OutFlgstring4N1 超时缴费 0 未超时缴费OutPayTimestring16N场内超时缴费时间(yyyy-MM-dd HH:mm:ss)OutPayFeestring4N场内超时缴费金额T

25、icketNostring12N未使用的有效停车卷号PayFeeint4N当前产生的停车费用(分)ParkSizestring12N大场，小场Memostring12Y备注5.1 出场车辆列表查询接口出场车辆列表查询接口 http:/ /App/getOutCarList.aspx提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号Tokenstring128N会话凭证(详情见名词解释)CarNostring12Y车牌号CarTypestring12Y车辆类型 A-H(月卡,月临,储值)例如月卡 AMachNostring16Y

26、开闸机号(ip 地址最后一段)Memostring12Y原因备注StartTimestring16Y出场时开始时间(yyyyMMddHHmmss)EndTimestring16Y出场时结束时间(yyyyMMddHHmmss)PageSizeint4N每页显示记录条数CurPageint4N当前查询页码返回参数返回参数:参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法TotalPageint4N总页数TotalCountint4N总记录数CarNostring12N车牌号码Car

27、Typestring4N车辆类型 A-H(月卡,月临,储值)例如月卡 AInPicPathstring125N入场图片路径InTimestring16N入场时结束时间(yyyy-MM-dd HH:mm:ss)InLaneNamestring16N入场车道名称OutPicPathstring125N出场图片路径OutTimestring16N出场时间(yyyy-MM-dd HH:mm:ss)OutLaneNamestring16N出场车道名称OutMachNostring32N出场控制机号PayFeestring16N停车总费用(分)ParkSizestring12N大场，小场Memostrin

28、g12Y备注5.3.月租车信息查询接口月租车信息查询接口http:/ /App/getMonInfo.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号Tokenstring128N会话凭证(详情见名词解释)CarNostring10N车牌号返回参数返回参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法CardNostring12N卡片号码CarTypestring12N车辆类型UserNostri

29、ng12N车主编号UserNamestring12N车主姓名Balanceint8N卡上余额(分)StartTimeDateTime8N生效开始时间(yyyy-MM-dd HH:mm:ss)EndTimeDateTime8N生效结束时间(yyyy-MM-dd HH:mm:ss)MachListstring255N机号列表(68,70,N,)MonFeeint8N月租金(分)SetNostring12N车位编号5.4.车道编号查询车道编号查询 http:/ /App/ getLaneList.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostrin

30、g12N车场编号车场编号Tokenstring128N会话凭证(详情见名词解释)InOutFlgstring12Y入口 In 出口 OutMachNostring16Y开闸机号(ip 地址最后一段)返回参数返回参数:参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法LaneNamestring4N车道名称MachNostring4N机号MachIpstring4N控制机 Ip 地址InOutFlgstring12N出口标志DvIpstring4N车道相机 IPOutPayFees

31、tring4N场内超时缴费金额5.5.查询车辆类型收费设置查询车辆类型收费设置 http:/ /App/ getFeeSet.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号Tokenstring128N会话凭证(详情见名词解释)返回参数返回参数:参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法CarTypestring4N车辆类型 A-H(月卡,月临,储值)例如临时卡 APointstring4N收费是否有小数点FeeSetStrstring12N收费设置字符串