开放接口
接口定位
慧猫开源停车平台提供两类开放接口：
- 设备开放接口：面向车牌识别相机、道闸、一体机、边缘网关和设备模拟器。
- 小程序开放接口：面向车主移动端扫码缴费、查单、支付记录和停车记录。
这些接口让停车业务可以脱离单一厂商，不被硬件锁死。
设备开放接口
基础路径：
/open/device
入场识别
POST /open/device/event/entry
设备识别到车辆入场时调用。平台根据车牌、车场、车道和设备信息生成或更新停车会话，并记录入场事件。
典型场景：
- 入口相机识别车牌。
- 一体机上报入场。
- 边缘网关统一转发厂商事件。
出场识别
POST /open/device/event/exit
设备识别到车辆准备离场时调用。平台查询在场会话，计算停车时长和应收金额，生成待支付订单或判断是否可直接放行。
典型场景：
- 未支付车辆生成缴费订单。
- 已支付且在宽限期内自动放行。
- 超过宽限期生成补费订单。
- 白名单或会员车辆按权益处理。
设备心跳
POST /open/device/event/heartbeat
设备定时上报在线状态，平台更新最后心跳时间。后续可结合定时任务实现离线告警、设备在线率统计和运维大屏。
开闸回调
POST /open/device/command/callback
设备执行开闸指令后回传结果。平台记录指令状态，形成“支付成功、下发开闸、设备执行、结果回传”的闭环。
小程序开放接口
基础路径：
/open/h5
查询停车场
GET /open/h5/lot/code/{lotCode}
按停车场编码查询公开信息，用于二维码入口、车场展示和缴费页初始化。
生成缴费二维码
GET /open/h5/lot/{lotCode}/qrcode
按停车场编码生成二维码图片，车场可张贴在岗亭、出口、墙面、电梯间或商户前台。
查询待支付订单
GET /open/h5/lot/{lotId}/order?plateNo=粤B12345
GET /open/h5/order?plateNo=粤B12345
车主输入车牌号查询待支付订单。可按车场限定，也可全局按车牌查询。
查询缴费记录
GET /open/h5/payment-records?plateNo=粤B12345
车主查看历史缴费记录，后续可扩展电子发票、退款申请和支付凭证。
查询停车记录
GET /open/h5/sessions?plateNo=粤B12345
车主查看历史停车记录，便于对账和申诉。
发起支付
POST /open/h5/order/{orderNo}/pay
当前支持模拟支付流程，后续可对接微信、支付宝、银联、聚合支付和无感支付。
接口扩展建议
真实项目中可继续扩展：
- 设备签名鉴权。
- 请求时间戳和重放防护。
- 厂商协议适配器。
- 支付回调验签。
- 会员权益查询接口。
- 商户发券与核销接口。
- 月租车续费接口。
- 访客预约接口。
- 发票申请接口。
- 监管平台数据上报接口。