本地软件F6-HTTP对接-停车场系统接口
昨天发布4805
智能摘要
还在为第三方支付系统接入停车场而头疼？这套完整的HTTP接口解决方案能帮你实现无缝对接！通过JSON格式实时获取车辆价格信息、处理支付结果、管理访客权限，甚至远程控制道闸开闭。无论你是开发人员还是系统集成商，只需调用标准接口就能快速打通支付环节，让车辆进出场流程更智能高效。
— 此摘要由停车技术员AI分析文章内容生成

HTTP对接-停车场系统接口

V1.2

2021-09-01 HTTP对接版本 1.0 梁工
2022-12-23 增加开闸接口 1.1 梁工
2024-08-22 完善开闸接口，访客接口 1.2 梁工

目的

主要解决第三方平台获取车牌识别软件的实时支付信息。通过支付信息，第三方进行

支付后，把数据传递到本地系统，达到第三方支付轻松接入本系统

接入方式

停车场服务器软件，HTTP 端口：9000，格式：json，编码：UTF8

http://127.0.0.1:9000/HttpAPI/

Post方式提交

接口列表

实时价格信息获取（当前通道金额查询）
预付价格信息获取（支持预支付金额查询）
订单支付结果通知（支付完毕发送数据至服务器）
访客接收，仅限访客增加接口
接收开闸接口
入场记录推送
出场记录推送

4.接口明细

(1)获取实时价格信息

字段 类型 必须 说明
service string Y 服务名: service.parking.payment.billing
version string Y 版本号: 1.0
charset string Y 字符集: UTF-8
sign string N 签名
park_uuid string N 停车场编号无需填写
plate string Y 支付车牌号
passport string N 用户通行证ID, 无牌车传入
gate_id string N 通道编号ID, 无牌车付费时可传递触发开闸.
seqNO int N 消息序列号，消息返回带回序列号
应答
字段 类型 必须 说明
service string Y 服务名: service.parking.payment.billing
version string Y 版本号: 1.0
charset string Y 字符集: UTF-8
result_code string Y 状态码:

值 含义

1001 订单获取成功, 业务参数将返回.

1002 未查询到停车信息.

1003 月卡车辆, 不允许支付.

1401 签名错误, 请检查配置.

1500 接口处理异常.
message 状态码处理描述, 如:返回错误信息.
sign 签名
plate 识别车牌号码.
parking_serial PK_Gateio表的Recordid
parking_order PK_Gateio表的Recordid
enter_time 入场时间, 格式 yyyyMMddHHmmss .
parking_time 停车时长(单位秒)
total_value 总停车费用(单位分), 为用户从入场到现在获取订单时的总费用.
free_value 已优惠金额(单位分), 为停车场在当前停车费用时已经给予的优惠金额,
paid_value 已支付金额(单位分）
pay_value 应支付金额(单位分),
enter_free_time 入场免费时间(单位秒)
buffer_time 当前系统预留出场时间(单位秒)
parking_ng_number 车辆所在位置信息, 例如: B660.
autopaystatus 自动支付状态: 1已开启, 0未开启
locking_status 锁车标识: 1已锁, 0未锁, 1不支持
seqNO 消息序列号

示例：

{

“charset”: “UTF-8”,

“gate_id”: “2”,

“park_uuid”: “”,

“passport”: “”,

“plate”: “”,

“service”: “service.parking.payment.billing”,

“sign”: “”,

“version”: “1.0”,

“seqNO”:12345

}

应答：

{

“message”: “实时通道支付信息”,

“parking_order”: “22492”,

“parking_serial”: “22492”,

“pay_value”: 1000,

“buffer_time”: 0,

“service”: “service.parking.payment.billing”,

“paid_value”: 0,

“locking_status”: 0,

“result_code”: “1001”,

“enter_time”: “20200115090155”,

“version”: “1.0”,

“free_value”: 0,

“charset”: “UTF-8”,

“parking_time”: 37844,

“seqNO”:123456,

“sign”: “”,

“total_value”: 1000,

“card_id”: “”,

“plate”: “云A12345”,

“gate_id”:2，

“seqNO”:123456

}

注意：价格需要从岗亭客户端获取当前正在支付的金额，如果岗亭客户端不在线，或者网络不佳可能无数据响应

(2)获取预付价格信息

字段 类型 必须 说明
service string Y 服务名: service.parking.payment.prepay
version string Y 版本号: 1.0
charset string Y 字符集: UTF-8
sign string N 签名 暂时为空
areaid int Y 停车区域ID 1,2,3…
park_uuid string N 停车场编号无需填写
plate string Y 支付车牌号
seqNO int N 消息序列号，消息返回带回序列号
应答
字段 类型 必须 说明
service string Y 服务名: service.parking.payment.prepay
version string Y 版本号: 1.0
charset string Y 字符集: UTF-8
result_code string Y 状态码:

值 含义

1001 订单获取成功, 业务参数将返回.

1002 未查询到停车信息.

1003 月卡车辆, 不允许支付.

1401 签名错误, 请检查配置.

1500 接口处理异常.
message 状态码处理描述, 如:返回错误信息.
sign 签名
plate 识别车牌号码.
parking_serial PK_Gateio表的Recordid
parking_order PK_Gateio表的Recordid
enter_time 入场时间, 格式 yyyyMMddHHmmss .
parking_time 停车时长(单位秒)
total_value 总停车费用(单位分), 为用户从入场到现在获取订单时的总费用.
free_value 已优惠金额(单位分), 为停车场在当前停车费用时已经给予的优惠金额,
paid_value 已支付金额(单位分）
pay_value 应支付金额(单位分),
enter_free_time 入场免费时间(单位秒)
buffer_time 当前系统预留出场时间(单位秒)
parking_ng_number 车辆所在位置信息, 例如: B660.
autopaystatus 自动支付状态: 1已开启, 0未开启
locking_status 锁车标识: 1已锁, 0未锁, 1不支持
seqNO 消息序列号

预支付 (无需传入gateid)示例：

{

“charset”: “UTF-8”,

“areaid”:1,

“plate”: “云A12345”,

“service”: “service.parking.payment.prepay”,

“sign”: “”,

“version”: “1.0”,

“seqNO”:1

}

回应：

{

“message”: “查询成功”,

“parking_order”: “22492”,

“parking_serial”: “22492”,

“enter_free_time”: 0,

“pay_value”: 1000,

“buffer_time”: 0,

“service”: “service.parking.payment.prepay”,

“paid_value”: 0,

“locking_status”: 0,

“result_code”: “1001”,

“enter_time”: “20200115090155”,

“version”: “1.0”,

“free_value”: 0,

“charset”: “UTF-8”,

“parking_time”: 33840,

“sign”: “”,

“total_value”: 1000,

“card_id”: “”,

“plate”: “云A12345”,

“seqNO”:1

}

(3).订单支付结果通知

请求参数

字段 类型 必须
service string Y 服务名:service.parking.payment.result
version string Y 版本号: 1.0
charset string N 字符集: UTF-8
sign string N 签名
park_uuid string N 停车场编号
parking_serial string Y 停车流水, 原客户端提交
parking_order string Y 停车支付订单号
gate_id string N 通道编号ID
pay_serial string Y 停车支付流水, 对账可用第三方的流水号
pay_time string Y 支付时间, 格式: yyyyMMddHHmmss
value int Y 支付金额(单位分)
pay_origin int Y 4 支付宝 8 微信
pay_origin_desc string Y 支付来源说明, 例如:微信支付，聚合支付

应答

字段 类型 必须
service string Y 服务名:service.parking.payment.result
version string Y 版本号: 1.0
charset string Y 字符集: UTF-8
sign string Y 签名
result_code string Y 1001 接口处理成功.

1401 签名错误, 请检查配置.

1403 订单已撤销.1.车辆出场2.参考7章节

1500 接口内部处理失败.
sign string Y 签名
message string Y 状态码处理描述, 如:返回错误信息

示例：

请求

{

“charset”: “UTF-8”,

“gate_id”: “2”,

“park_uuid”: “1f798d2b-5116-43b4-b296-0df0cc71b85d”,

“parking_order”: “59877”,

“parking_serial”: “59877”,

“pay_origin”: “8”,

“pay_origin_desc”: “微信”,

“pay_serial”: “20200115210308075520112989”,

“pay_time”: “20200115210315”,

“plate”: “云A12345”,

“service”: “service.parking.payment.result”,

“sign”: “5E9648695F9A54F18B502373B261A8E8”,

“value”: “600”,

“version”: “1.0”,

“seqNO”:123

}

应答

{

“Message”: “订单处理成功”,

“service”: “service.parking.payment.result”,

“result_code”: “1001”,

“version”: “1.0”,

“charset”: “UTF-8”,

“sign”: “”

“seqNO”:123

}

(4).访客推送，只有增加访客的接口

请求参数

字段 类型 必须
service string Y 服务名:service.parking.fangke
version string Y 版本号: 1.0
charset string N 字符集: UTF-8
sign string N 签名
plate string Y 车牌号码
begintime string Y yyyyMMddHHmmss开始时间
endtime string Y yyyyMMddHHmmss结束时间
b1 string N 备注1 车主姓名或其他
b2 string N 备注2 电话或其他
b3 string N 备注3
b4 int N 备注4
seqNO int N 流水号

应答

字段 类型 必须
service string Y 服务名:service.parking.fangke
version string Y 版本号: 1.0
charset string Y 字符集: UTF-8
sign string Y 签名
result_code string Y 1001 接口处理成功.

1002 接口处理失败.
sign string Y 签名
message string Y 状态码处理描述, 如:返回错误信息
seqNO int N 流水号

添加完成，可使用客户端进入 -车牌管理，-访客车牌，查看数据，或者数据库CarRight

示例：

请求

{

“charset”: “UTF-8”,

“plate”: “2”,

“begintime”: “20210415000315”,

“endtime”: “20210416000315”,

“b1”: “访客_刘备”,

“b2”: “15999999999”,

“b3”: “45041111111111111”,

“b4”: “到访 茅庐 孔明 家”,

“service”: “service.parking.fangke”,

“sign”: “”,

“version”: “1.0”,

“seqNO”:123

}

应答

{

“Message”: “订单处理成功”,

“service”: “service.parking.payment.result”,

“result_code”: “1001”,

“version”: “1.0”,

“charset”: “UTF-8”,

“sign”: “”

“seqNO”:123

}

(5)开闸接口

请求参数

字段 类型 必须
service string Y 服务名:service.parking.setopenstrobe
version string Y 版本号: 1.0
charset string N 字符集: UTF-8
sign string N 签名
geteid string Y 通道编号
opentype int Y 0是开闸单通道，1是关闸，(出于安全考虑目前版本软件都屏蔽关闸功能，需要的话提供特殊版本)
gatename string Y 通道名称
seqNO int N 流水号

响应

字段 类型 必须
service string Y 服务名:service.parking.setopenstrobe
version string Y 版本号: 1.0
charset string Y 字符集: UTF-8
sign string Y 签名
result_code string Y 1001 接口处理成功.

1002 接口处理失败.
sign string Y 签名
message string Y 状态码处理描述, 如:返回错误信息
seqNO int N 流水号

示例：

{

“charset”: “UTF-8”,

“gateid”:1,

“opentype”:1,

“gatename”:”入口”,

“service”: “service.parking.setopenstrobe”,

“sign”: “”,

“version”: “1.0”,

“seqNO”:123

}

应答：

{

“message”: “已执行操作”,

“service”: “service.parking.setopenstrobe”,

“result_code”: “1001”,

“version”: “1.0”,

“charset”: “UTF-8”,

“sign”: “”

}

注意：

  1. 关闭原停车系统的云支付功能

descript

HTTP Post 入场纪录

URL再系统配置中配置 /IN

调用如下：http://192.168.1.200:5061/api/IN

body json

plate 车牌号码 string N 粤B12345
enter_time 入场时间, 单位ms long 时间戳 1552976318722
enter_gate 入口名称 string N 东门入口
car_type 车类: 1.临停车辆, 2.月卡车辆, 3.贵宾车辆(免费车), 4.储值车辆, 0.其他未知 string Y 1
parking_serial 停车场端的停车流水, 一般为入场记录ID string Y 101
plateColor 车牌颜色: 1.蓝色, 2.黄色, 3.白色, 4.黑色, 5.绿色, -1 未知 string

(7)HTTP Post 出场记录

body json

URL在系统配置中配置 /OUT

调用如下：http://192.168.1.200:5061/api/OUT

parking_serial 停车场端的停车流水, 一般为入场记录ID string Y 101
plate 车牌号码 string N 粤B12345
plate_color 车牌颜色: 1.蓝色, 2.黄色, 3.白色, 4.黑色, 5.绿色, -1 未知 string Y 1
leave_time 离场时间, 单位ms long
leave_gate 出口名称 string
total_value 总停车总费用, 单位分 string N 1000
parking_timelong 停车时长 string
© 版权声明

本站收集的资源仅供内部学习研究软件设计思想和原理使用，学习研究后请自觉删除，请勿传播，因未及时删除所造成的任何后果责任自负。

如果用于其他用途，请购买正版支持作者，谢谢！若您认为「BLOG.SDLINKA.COM」发布的内容若侵犯到您的权益，请联系站长进行删除处理。

本站资源大多存储在云盘，如发现链接失效，请联系我们，我们会第一时间更新。
评论 抢沙发

请登录后发表评论

    暂无评论内容

搜索停车管理本地端
停车管理本地...
搜索停车管理本地端
主题文档