# 自行车 mqtt 协议文档

## 通信规范
- 每个站点一个 mqtt 连接，clientId 为 SITE_站点编号
- 一个站点由部署在上位机上的软件通过can总线与多个锁通信，并与服务器通过mqtt做消息转发


## sub: device/lock/{id}/info
> **锁信息，在初始化、状态变更时会推送锁的完整状态**
- 数据
```json
{
    "siteId": "1015", // 站点编号 
    "code": "01", // 锁编号
    "id": "123456789103", // 锁唯一id,同主题{id}
    "status": 1, // 状态，0闭合, 1打开，2运行中, 3异常
    "bikeCode": "1234567890" // 自行车ic卡号，无车为空
}
```

## pub: device/lock/{id}/getInfo
> 实时获取锁信息
- 数据
```json
{}
```

## pub: device/lock/{id}/unlock
> 开锁，成功失败可关注info消息推送
- 数据
```json
{}
```

## sub: device/lock/{id}/bike
> 还车, 还车成功时，获得所还车辆ic卡号推送
- 数据
```json
{
    "bikeCode": "1234567890",
    "time": "2023-10-13 10:12:90" // 站点上位机收到还车指令的时间，仅做参考，请以服务器时间为准
}
```