停车场与碧园APP对接测试接口.doc
《停车场与碧园APP对接测试接口.doc》由会员分享,可在线阅读,更多相关《停车场与碧园APP对接测试接口.doc(22页珍藏版)》请在得力文库 - 分享文档赚钱的网站上搜索。
1、智享停车平台对接协议智享停车平台对接协议 序序: 测试环境地址测试环境地址: http:/ 正式环境地址正式环境地址: http:/1.智享平台: http:/ (本平台也可以单独部署到您的云服务器上) 2.通讯方式:Http, https 3.提交数据格式:Url string 4.返回数据格式:XML 5.编码格式:utf-8 一一: :添加添加车场编号车场编号生成生成车场车场PkeyPkey二二: :生成会话凭证生成会话凭证TokenToken 例例: : 原始原始URLURLstring PostUrl=“http:/ 生成加密生成加密TokenToken string TokenTo
2、ken = MD5(PostUrl .ToLower() + PkeyPkey .ToLower();/加密字串转换小写后 加密 提交提交URLURLstring PostUrl= PostUrl +“智享停车测试环境智享停车测试环境( (验证您拼装的参数是否正确验证您拼装的参数是否正确) ):测试地址测试地址: : http:/ 2.1运营商测试账户用户名:13418901852密码:123456 2.2车场物业测试账户车场编号:13418901852用户名:888888密码:123456三三: :任务接收回调程序部署任务接收回调程序部署3.13.1在您自己的云端程序嵌入回调程序在您自己的云
3、端程序嵌入回调程序( (回调程序回调程序DemoDemo下载地址下载地址: : http:/ 3.2 智享停车物业后台配置回调地址( (http:/您的域名/二级目录/ Task.aspx )3.3:3.3:任务通知回调流程任务通知回调流程3.43.4任务通知接口任务通知接口 http:/您的域名/二级目录/ Task.aspx 提交参数提交参数参数名称参数名称数据数据 类型类型长度长度为空为空备注备注ParkNostring11N车场编号Tokenstring128N会话凭证(详情见名词解释)TaskNamestring11N事件名称(见任务说明表)TaskApistring128N事件回调
4、接口(见任务说明表)TaskKey1string12N第一个关键字Key1Valuestring32N第一个关键字值TaskKey2string12N第二个关键字Key2Valuestring32Y第二个关键字值,格式:yyyyMMddHHmmssbig_tatolsetstring5N大场总车位(只在入场通知,出场通知提交该参 数)big_nullsetstring5N大场余位(只在入场通知,出场通知提交该参数)mini_tatolsetstring5N小场总车位(只在入场通知,出场通知提交该参 数)mini_nullsetstring5N小场余位(只在入场通知,出场通知提交该参数)返回参数
5、返回参数MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法事件任务说明表事件任务说明表 根据不同的TaskName参数,远程回调对应的接口,接口详细说明如下:事件名称事件名称功能说明功能说明事件数据获取接事件数据获取接 口口接口关键字参数说明InCar入场通知/App/getInCar.aspxTaskKey1: CarNo Key1Value: 粤B12345TaskKey2: InTime Key2Value: 2018-05-16 12:20:34WaitOut等待出场通 知/App/getWaitOut.a spxTaskKe
6、y1: CarNo Key1Value: 粤B12345TaskKey2: OutTime Key2Value: 2018-05-16 12:20:34OutCar开闸出场通 知/App/getOutCar.as pxTaskKey1: CarNo Key1Value: 粤B12345TaskKey2: OutTime Key2Value: 2018-05-16 12:20:34MonCar月租变更通 知/App/getMonCar.a spxTaskKey1: OrderNo Key1Value: SO12345678 TaskKey2: TaskTime Key2Value: 2018-0
7、5-16 12:20:34PayPost机器人扫码 支付支付成功: 任务方法返回结 果(同步)或异 步通知: /App/UpPayNotify. aspxTaskKey1: CarNo Key1Value: 粤B12345 TaskKey2: OrderNo(订单编号,异步通知 时需要回传)Key2Value: 7B81C09920181210163216218 PayFee:1(实收费用,单位分) MustFee:1(应收费用,单位分) AuthCode: 134576569615533020 (支付 授权码)3.4.13.4.1 PayPost(PayPost(机器人扫码支付通知任务机器人
8、扫码支付通知任务) )说明说明 1)车辆出场机器人扫支付码支付,不需要调取 4.1.临停缴费确认下单接口2)第三方支付完成后需要通过两种方式返回支付结果:任务方法返回结果(同步)和 异步返回结果(见4.3 /App/UpPayNotify.aspx)。 同步返回示例(json):参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号OrderNostring64N订单编号(即支付授权码)PayType Description(“微信“)WeiXin,Description(“支付宝“)AliPay,Description(“银联“)UnionPa
9、y,Description(“现金“)Cash,Description(“预存支付“)AppPay,Description(“支付宝无感付“)AliPayAuto,Description(“微信无感付“)WeiXinAutoDescription(“银联无感付“)UnionAuto,Description(“其他“)Other,PayNostring32N支付平台支付流水号OutTradeNostring32N支付平台下单号支付成功:“ParkNo“: “13632792802“,“OrderNo“: “134576569615533020“,“PayType“: “weixin“,“PayN
10、o“: “4200000160201809176195044548“,“OutTradeNo“: “178007670130411900“,“state“: 0,“errmsg“: “success“ 除支付成功外的状态(失败或等待),需要通过异步通知操作:“state“: 1,“errmsg“: “fail“3.5 入场通知入场通知_回调接口回调接口http:/http:/ /App/ getInCar.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号InTimestring1
11、6N入场时间(yyyyMMddHHmmss)Tokenstring128N会话凭证(详情见名词解释)返回参数返回参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring4N错误代码CardNostring12N卡片号码CarNoString12N车牌号码CarTypeString12N车辆类型 A-H(月卡,临时,月临,储值)例如月卡 AInLaneString12N入场车道名InTimeDateTime16N入场时间(yyyy-MM-dd HH:mm:ss)InPicString125N入场图
12、片路劲PayFeestring12N场内缴费金额(元)PayTimeDateTime16N场内缴费时间OutPayFeestring12N场内超时缴费金额(元)OutPayTimestring12N场内超时缴费时间InMachIpstring16N入场机器 Ip3.6. 等待出场通知等待出场通知_回调接口回调接口http:/http:/ /App/ getWaitOut.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号OutTimestring6N出场时间(yyyyMMddHHm
13、mss)Tokenstring128N会话凭证(详情见名词解释)返回参数返回参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码OutMachIpstring12N车道控制机 IpOutLaneString32N出场车道名称OutTimeString8N出场时间(yyyy-MM-dd HH:mm:ss)OutTypeString12N刷卡 Card,手机号 Phone,扫码 ScanCode,普通牌 CarNo,新能源 NewCar,人脸 Face,证件 ID,指纹 FintOutPicstring255Y出场图片路
14、径CarTypestring12N车辆类型 A-H(月卡,月临,储值)例如月卡 ATicketNostring8N停车卷号PayFeeint8N支付金额(分)3.7. 开闸出场通知开闸出场通知_回调接口回调接口http:/http:/ /App/ getOutCar.aspx 提交参数提交参数参数名称参数名称数据类数据类 型型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号OutTimestring14Y出场时间(yyyyMMddHHmmss)Tokenstring128N会话凭证(详情见名词解释)返回参数返回参数参数名称参数名称数据类
15、数据类 型型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码InMachIpstring12N车道控制机 IpInLaneString32N入场车道名称InTimeString14N入场时间(yyyy-MM-dd HH:mm:ss)InPicString255N入场图片路径InTypeString12N入场方式(识别,扫码,手机号,刷卡,手动开闸)InMachIpstring12N车道控制机 IpOutLaneString32N出场车道名称OutMachIpstring12N出场车道控制机 IpOutLaneString32N出场车道名称OutTi
16、meString14N出场时间(yyyy-MM-dd HH:mm:ss)OutTypeString12N出场方式(识别,扫码,手机号,刷卡,手动开闸)MustFeeint4N应收金额分为单位PayFeeint4N实收金额分为单位OutMachIpstring16N出场机器 Ip3.8.月租车变更通知月租车变更通知_回调接口回调接口http:/ /App/getMonCar.aspx 提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号TaskTimestring14Y事件发生时间(yyyyMMddHH
17、mmss)Tokenstring128N会话凭证(详情见名词解释)返回参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法CardNostring12N卡片号码CarTypestring12N车辆类型UserNostring12N车主编号UserNamestring12N车主姓名StartTimeDateTime8N生效开始时间(yyyy-MM-dd HH:mm:ss)EndTimeDateTime8N生效结束时间(yyyy-MM-dd HH:mm:ss)MachListstr
18、ing255N机号列表(68,70,N,)四四:停车支付下单接口停车支付下单接口4.1.临停缴费确认下单接口临停缴费确认下单接口http:/http:/ /App/ getTmpFee.aspx 提交参数提交参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号ParkSizestring6N大小场标识BIG大,Mini小Tokenstring128N会话凭证(详情见名词解释)返回参数返回参数参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring64N错误描述ErrNostring
19、4N错误代码WayInfostring64Y错误处理办法OrderNoString64N订单号流水号(加密字符串)PayTimeString64N计费截止时间:yyyy-MM-dd HH:mm:ssMustFeeint4N应收金额分为单位PayFeeint4N实收金额分为单位FeeTypeint8N正常缴费(0)超时补费(1)StopTimeString16N停车时长 N 天 N 时 N 分 N 秒OutTimeString16N缴费到出场允许滞留时间 N 天 N 时 N 分 N 秒TicketNoString8Y停车卷号DistTypeString8Y折扣类型(全免,免时,免钱,多次全免,优
20、惠价)ManageIdint8N入场操作员编号PicPathstring255Y入场图片路劲CarTypestring12N车辆类型 A-H(月卡,月临,储值)例如”临时卡 A”4.2.月租延期下单接口月租延期下单接口http:/ /App/getMonFee.aspx 提交参数参数名称参数名称数据类数据类 型型长度长度为空为空备注备注ParkNostring12N车场编号车场编号CarNostring10N车牌号MonCntint4N几个月Tokenstring128N会话凭证(详情见名词解释)返回参数参数名称参数名称数据类型数据类型长长 度度为空为空备注备注MsgStrstring4N错
21、误描述ErrNostring4N错误代码WayInfostring64Y解决办法OrderNostring32N订单号CarTypestring12N车辆类型UserNostring12N车主编号UserNamestring12N车主姓名StartTimeDateTime8N生效开始时间(yyyy-MM-dd HH:mm:ss)EndTimeDateTime8N生效结束时间(yyyy-MM-dd HH:mm:ss)MonFeeint8N月租费用(分)MonTotalFeeint8N延期总金额(分)CarTypestring12N车辆类型 A-H(月卡,月临,储值)例如月卡 A4.3.支付通知接
22、口支付通知接口http:/ /App/UpPayNotify.aspx发送参数发送参数:参数名称参数名称数据类型数据类型长度长度为空为空备注备注ParkNostring12N车场编号车场编号OrderNostring64N订单编号Tokenstring128N会话凭证(详情见名词解释)PayStatusstring12N状态(Wait 等待,Lost 失败,OK 成功,取消 Cancel)PayType Description(“微信“)WeiXin,Description(“支付宝“)AliPay,Description(“银联“)UnionPay,Description(“现金“)Cas
23、h,Description(“预存支付“)AppPay,Description(“支付宝无感付“)AliPayAuto,Description(“微信无感付“)WeiXinAutoDescription(“银联无感付“)UnionAuto,Description(“其他“)Other,PayNostring32N支付平台支付流水号OutTradeNostring32N支付平台下单号返回参数返回参数:参数名称参数名称数据类型数据类型长度长度为空为空备注备注MsgStrstring4N错误描述ErrNostring4N错误代码WayInfostring64Y解决办法五五:主动上报接口主动上报接口5
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 停车场 app 对接 测试 接口
限制150内