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

1、智享停车平台对接协议 序 : 1.智享平台 :http:/(本平台也可以单独部署到您的云服务器上 ) 2.通讯方式 :Http, https 3.提交数据格式 :Url string 4.返回数据格式 :XML 5.编码格式 :utf-8 一 :添加 车场编号 生成 车场 Pkey 二 :生成会话凭证 Token 例 : 原始 URL string PostUrl=“http:/ 生成加密 Token string Token = MD5(PostUrl .ToLower() + Pkey .ToLower();/加密字串转换小写后加密 提交 URL string PostUrl= PostU

2、rl +“ 智享停车测试 环境 (验证您拼装的参数是否正确 ): 测试地址 :http:/ 2.1运营商测试账户 用户名 :13418901852 密码 :123456 2.2车场物业测试账户 车场编号 :13418901852 用户名 :888888 密码 :123456 三 :任务接收回调程序部署 3.1在您自己的云端程序嵌入回调程序 (回调程序下载 :http:/ 3.2智享停车物业后台配置回调地址 (http:/您的域名 /二级目录 / Task.aspx ) 3.3:任务通知回调流程 3.4任务通知接口 http:/您的域名 /二级目录 / Task.aspx 提交参数 参数名称 数

3、 据类型 长度 为空 备注 ParkNo string 11 N 车场编号 Token string 128 N 会话凭证 (详情见名词解释 ) TaskName string 11 N 事件名称 (见任务说明表 ) TaskApi string 128 N 事件回调接口 (见任务说明表 ) TaskKey1 string 12 N 第一个关键字 Key1Value string 32 N 第一个关键字值 TaskKey2 string 12 N 第二个关键字 Key2Value string 32 Y 第二个关键字值，格式： yyyyMMddHHmmss big_tatolset strin

4、g 5 N 大场总车位（只在入场通知，出场通知提交该参数） big_nullset string 5 N 大场余位（只在入场通知，出场通知提交该参数） mini_tatolset string 5 N 小 场总车位（只在入场通知，出场通知提交该参数） mini_nullset string 5 N 小场余 位（只在入场通知，出场通知提交该参数） 返回参数 MsgStr string 4 N 错误描述 ErrNo string 4 N 错误代码 WayInfo string 64 Y 解决办法 事件任务说明表 根据不同的 TaskName参数，远程回调对应的接口，接口详细说明如下： 事件名称 功

5、能说明 事件数据获取接口 TaskKey1 Key1Value TaskKey2 Key2Value InCar 入场通知 /App/getInCar.aspx CarNo 粤 B12345 InTime 2018-05-16 12:20:34 WaitOut 等待出场通知 /App/getWaitOut.aspx CarNo 粤 B12345 OutTime 2018-05-16 12:20:34 OutCar 开闸出场通知 /App/getOutCar.aspx CarNo 粤 B12345 OutTime 2018-05-16 12:20:34 MonCar 月租变更通知 /App/ge

6、tMonCar.aspx OrderNo “ 12345678” TaskTime 2018-05-16 12:20:34 3.5 入场通知 _回调接口 http:/ getInCar.aspx 提交参数 参数名称 数据类型 长度 为空 备注 ParkNo string 12 N 车场编号 CarNo string 10 N 车牌号 InTime string 16 N 入场时间 (yyyyMMddHHmmss) Token string 128 N 会话凭证 (详情见名词解释 ) 返回参数 参数名称 数据类型 长度 为空 备注 MsgStr string 4 N 错 误描述 ErrNo st

7、ring 4 N 错误代码 WayInfo string 4 N 错误代码 CardNo string 12 N 卡片号码 CarNo String 12 N 车牌号码 CarType String 12 N 车辆类型 A-H(月卡 ,临时 ,月临 ,储值 )例如月卡 A InLane String 12 N 入场车道名 InTime DateTime 16 N 入场时间 (yyyy-MM-dd HH:mm:ss) InPic String 125 N 入场图片路劲 PayFee string 12 N 场内缴费金额 (元 ) PayTime DateTime 16 N 场内缴费时间 OutP

8、ayFee string 12 N 场内超时缴费金额 (元 ) OutPayTime string 12 N 场内超时缴费时间 InMachIp string 16 N 入场机器 Ip 3.6. 等待出场通知 _回调接口 http:/ getWaitOut.aspx 提交参数 参数名称 数据类型 长度 为空 备注 ParkNo string 12 N 车场编号 CarNo string 10 N 车牌号 OutTime string 6 N 出场时间 (yyyyMMddHHmmss) Token string 128 N 会话凭证 (详情见名词解释 ) 返回参数 参数名称 数据类型 长度 为空

9、 备注 MsgStr string 4 N 错误描述 ErrNo string 4 N 错误代码 OutMachIp string 12 N 车道控制机 Ip OutLane String 32 N 出场车道名称 OutTime String 8 N 出场时间 (yyyy-MM-dd HH:mm:ss) OutType String 12 N 刷卡 Card,手机号 Phone,扫码 ScanCode,普通牌CarNo,新能源 NewCar,人脸 Face,证件 ID,指纹 Fint OutPic string 255 Y 出场图片路径 CarType string 12 N 车辆类型 A-H

10、(月卡 ,月临 ,储值 )例如月卡 A TicketNo string 8 N 停车卷号 PayFee int 8 N 支付金额 (分 ) 3.7. 开闸出场通知 _回调接口 http:/ getOutCar.aspx 提交参数 参数名称 数据类型 长度 为空 备注 ParkNo string 12 N 车场编号 CarNo string 10 N 车牌号 OutTime string 14 Y 出场时间 (yyyyMMddHHmmss) Token string 128 N 会话凭证 (详情见名词解释 ) 返回参数 参数名称 数据类型 长度 为空 备注 MsgStr string 4 N 错

11、误描述 ErrNo string 4 N 错误代码 InMachIp string 12 N 车道控制机 Ip InLane String 32 N 入场车道名称 InTime String 14 N 入场时间 (yyyy-MM-dd HH:mm:ss) InPic String 255 N 入场图片路径 InType String 12 N 入场方式 (识别 ,扫码 ,手机号 ,刷卡 ,手动开闸 ) InMachIp string 12 N 车道控制机 Ip OutLane String 32 N 出场车道名称 OutMachIp string 12 N 出场车道控制机 Ip OutLane

12、 String 32 N 出场车道名称 OutTime String 14 N 出场时间 (yyyy-MM-dd HH:mm:ss) OutType String 12 N 出场方式 (识别 ,扫码 ,手机号 ,刷卡 ,手动开闸 ) MustFee int 4 N 应收金额分为单位 PayFee int 4 N 实收金额分为单位 OutMachIp string 16 N 出场机器 Ip 3.8.月租车变更通知 _回调接口 http:/ /App/getMonCar.aspx 提交参数 参数名称 数据类型 长度 为空 备注 ParkNo string 12 N 车场编号 CarNo strin

13、g 10 N 车牌号 TaskTime string 14 Y 事件发生时间 (yyyyMMddHHmmss) Token string 128 N 会话凭证 (详情见名词解释 ) 返回参数 参数名称 数据类型 长度 为空 备注 MsgStr string 4 N 错误描述 ErrNo string 4 N 错误代码 WayInfo string 64 Y 解决办法 CardNo string 12 N 卡片号码 CarType string 12 N 车辆类型 UserNo string 12 N 车主编号 UserName string 12 N 车主姓名 StartTime DateTi

14、me 8 N 生效开始时间 (yyyy-MM-dd HH:mm:ss) EndTime DateTime 8 N 生效结束时间 (yyyy-MM-dd HH:mm:ss) MachList string 255 N 机号列表 (68,70,N,) 四 :停车支付下单接口 4.1.临停缴费确认下单接口 http:/ getTmpFee.aspx 提交参数 参数名称 数据类型 长度 为空 备注 ParkNo string 12 N 车场编号 CarNo string 10 N 车牌号 ParkSize string 6 N 大小场标识 BIG大 ,Mini小 Token string 128 N

15、会话凭证 (详情见名词解释 ) 返回参数 参数名称 数据类型 长度 为空 备注 MsgStr string 64 N 错误描述 ErrNo string 4 N 错误代码 WayInfo string 64 Y 错误处理办法 OrderNo String 64 N 订单号流水号 (加密字符串 ) PayTime String 64 N 计费截止时间 :yyyy-MM-dd HH:mm:ss MustFee int 4 N 应收金额分为单位 PayFee int 4 N 实收金额分为单位 FeeType int 8 N 正常缴费（ 0）超时补费（ 1） StopTime String 16 N

16、停车时长 N 天 N 时 N 分 N 秒 OutTime String 16 N 缴费到出场允许滞留时间 N 天 N 时 N 分 N 秒 TicketNo String 8 Y 停车卷号 DistType String 8 Y 折扣类型 (全免 ,免时 ,免钱 ,多次全免 ,优惠价 ) ManageId int 8 N 入场操作员编号 PicPath string 255 Y 入场图片路劲 CarType string 12 N 车辆类型 A-H(月卡 ,月临 ,储值 )例如 ”临时卡 A” 4.2.月租延期下单接口 http:/ /App/getMonFee.aspx 提交参数 参数名称 数

17、据类型 长度 为空 备注 ParkNo string 12 N 车场编号 CarNo string 10 N 车牌号 MonCnt int 4 N 几个月 Token string 128 N 会话凭证 (详情见名词解释 ) 返回参数 参数名称 数据 类型 长度 为空 备注 MsgStr string 4 N 错误描述 ErrNo string 4 N 错误代码 WayInfo string 64 Y 解决办法 OrderNo string 32 N 订单号 CarType string 12 N 车辆类型 UserNo string 12 N 车主编号 UserName string 12

18、N 车主姓名 StartTime DateTime 8 N 生效开始时间 (yyyy-MM-dd HH:mm:ss) EndTime DateTime 8 N 生效结束时间 (yyyy-MM-dd HH:mm:ss) MonFee int 8 N 月租费用 (分 ) MonTotalFee int 8 N 延期总金额 (分 ) CarType string 12 N 车辆类型 A-H(月卡 ,月临 ,储值 )例如月卡 A 4.3.支付通知接口 http:/ /App/UpPayNotify.aspx 发送参数 : 参数名称 数据类型 长度 为空 备注 ParkNo string 12 N 车场

19、编号 OrderNo string 64 N 订单编号 Token string 128 N 会话凭证 (详情见名词解释 ) PayStatus string 12 N 状态 (Wait等待 ,Lost 失败 ,OK成功 ,取消 Cancel) PayType Description(“微信 “) WeiXin, Description(“支付宝 “) AliPay, Description(“银联 “) UnionPay, Description(“现金 “) Cash, Description(“预存支付 “) AppPay, Description(“支付宝无感付 “) AliPayAu

20、to, Description(“微信无感付 “) WeiXinAuto Description(“银联无感付 “) UnionAuto, Description(“其他 “) Other, PayNo string 32 N 支付平台支付流水号 OutTradeNo string 32 N 支付平台下单号 返回参数 : 参数名称 数据类型 长度 为空 备注 MsgStr string 4 N 错误描述 ErrNo string 4 N 错误代码 WayInfo string 64 Y 解决办法 五 :主动上报接口 5.1.月租变更上传接口 http:/ /App/UpMonCar.aspx

21、提交参数 参数名称 数据类型 长度 为空 备注 ParkNo string 12 N 车场编号 CarNo string 10 N 车牌号 Token string 128 N 会话凭证 (详情见名词解释 ) UserName string 12 N 车主姓名 OperType string 12 N Description(“新增 “) Add, Description(“删除 “) Del, Description(“修改 “) Edit, Description(“充值 “) Fill, Description(“延期 “) Delay, Fee string 12 N 充值延期金额 (

22、分 ) StartTime string 16 N 新的有效开始时间 EndTime string 16 N 新的有效结束时间 CarType string 12 N 车辆类型 A-H(月卡 ,月临 ,储值 )例如月卡 A CardStatus int 4 N 正常使用 :0,退卡 OK : 5, Balance int 4 N 余额 (分 ) MachList string 255 N 通行机号列表 45_68_70_90_N(ip 地址最后一段以 ”_”结尾 ) SetNo string 12 N 车位编号 返回参数 参数名称 数据类型 长度 为空 备注 MsgStr string 4 N

23、 错误描述 ErrNo string 4 N 错误代码 WayInfo string 64 Y 解决办法 5.2.手动放行上传接口 http:/ /App/ UpOpenCmd.aspx 提交参数 参数名称 数据类型 长度 为空 备注 ParkNo string 12 N 车场编号 Token string 128 N 会话凭证 (详情见名词解释 ) CarNo string 12 N 车牌号 CarType string 12 N 车辆类型 A-H(月卡 ,月临 ,储值 )例如月卡 A MachNo string 16 N 开闸机号 (ip 地址最后一段 ) PayFee string 16

24、 Y 实收金额 (可不传 ) Memo string 64 N 放行原因 返回参数 : 参数名称 数 据类型 长度 为空 备注 MsgStr string 4 N 错误描述 ErrNo string 4 N 错误代码 WayInfo string 64 Y 解决办法 六 :主动查询接口 6.1.场内车辆列表查询接口 http:/ /App/getInCarList.aspx 提交参数 参数名称 数据类型 长度 为空 备注 ParkNo string 12 N 车场编号 Token string 128 N 会话凭证 (详情见名词解释 ) CarNo string 12 Y 车牌号 CarTyp

25、e string 12 Y 车辆类型 A-H(月卡 ,月临 ,储值 )例如月卡 A MachNo string 16 Y 开闸机号 (ip 地址最后一段 ) Memo string 12 Y 原因备注 StartTime string 16 Y 入场时开始时间 (yyyyMMddHHmmss) EndTime string 16 Y 入场时结束时间 (yyyyMMddHHmmss) PageSize int 4 N 每页显示记录条数 CurPage int 4 N 当前查询页码 返回 参数 : 参数名称 数据类型 长度 为空 备注 MsgStr string 4 N 错误描述 ErrNo st

26、ring 4 N 错误代码 WayInfo string 64 Y 解决办法 TotalPage int 4 N 总页数 TotalCount int 4 N 总记录数 CarNo string 12 N 车牌号码 CarType string 4 N 车辆类型 A-H(月卡 ,月临 ,储值 )例如月卡 A InPicPath string 125 N 入场图片路径 InTime string 16 N 入场时结束时间 (yyyy-MM-dd HH:mm:ss) InMachNo string 32 N 入场控制机号 PayTime string 16 N 场内支付时间 (yyyy-MM-dd

27、 HH:mm:ss) OutFlg string 4 N 1 超时缴费 0 未超时缴费 OutPayTime string 16 N 场内超时缴费时间 (yyyy-MM-dd HH:mm:ss) OutPayFee string 4 N 场内超时缴费金额 TicketNo string 12 N 未使用的 有效停车卷号 PayFee int 4 N 当前产生的停车费用 (分 ) ParkSize string 12 N 大场，小场 Memo string 12 Y 备注 6.2.出场车辆列表查询接口 http:/ /App/getOutCarList.aspx 提交参数 参数名称 数据类型 长

28、度 为空 备注 ParkNo string 12 N 车场编号 Token string 128 N 会话凭证 (详情见名词解释 ) CarNo string 12 Y 车牌号 CarType string 12 Y 车辆类型 A-H(月卡 ,月临 ,储值 )例如月卡 A MachNo string 16 Y 开闸机号 (ip 地址最后一段 ) Memo string 12 Y 原因备注 StartTime string 16 Y 出场时开始时间 (yyyyMMddHHmmss) EndTime string 16 Y 出场时结束时间 (yyyyMMddHHmmss) PageSize int

29、 4 N 每页显示记录条数 CurPage int 4 N 当前查询页码 返回参数 : 参数名称 数 据类型 长度 为空 备注 MsgStr string 4 N 错误描述 ErrNo string 4 N 错误代码 WayInfo string 64 Y 解决办法 TotalPage int 4 N 总页数 TotalCount int 4 N 总记录数 CarNo string 12 N 车牌号码 CarType string 4 N 车辆类型 A-H(月卡 ,月临 ,储值 )例如月卡 A InPicPath string 125 N 入场图片路径 InTime string 16 N 入场时 结束时间 (yyyy-MM-dd HH:mm:ss) InLaneName string 16 N 入场车道名称 OutPicPath string 125 N 出场图片路径 OutTime string 16 N 出场时间 (yyyy-MM-dd HH:mm:ss) OutLaneName string 16 N 出场车道名称