|
|
# IoT 数据上报接口文档
|
|
|
|
|
|
## 基本信息
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 协议 | HTTP/1.1 |
|
|
|
| 方法 | POST |
|
|
|
| Content-Type | application/json; charset=UTF-8 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 接口地址
|
|
|
|
|
|
```
|
|
|
POST /api/iot/data/report
|
|
|
```
|
|
|
|
|
|
一次请求查询**所有库点**的设备数据，按库点位置分组。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 响应参数
|
|
|
|
|
|
### Body
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"code": 0,
|
|
|
"message": "ok",
|
|
|
"data": [
|
|
|
{
|
|
|
"deviceName": "非动碰盘点1号巷道盘点系统",
|
|
|
"time": "2026-06-26 09:30:00",
|
|
|
"warehouseRunStatus": 3,
|
|
|
"warehouseNetworkStatus": 1,
|
|
|
"leftScannerNetworkStatus": 1,
|
|
|
"leftScannerScanResult": 1,
|
|
|
"leftDepthScannerNetworkStatus": 1,
|
|
|
"leftDepthScannerScanResult": 1,
|
|
|
"rightScannerNetworkStatus": 1,
|
|
|
"rightScannerScanResult": 1,
|
|
|
"rightDepthScannerNetworkStatus": 1,
|
|
|
"rightDepthScannerScanResult": 1,
|
|
|
"cameraNetworkStatus": 1,
|
|
|
"cameraErrorCode": 0,
|
|
|
"apNetworkStatus": 1,
|
|
|
"SRMNumber": "001",
|
|
|
"cpeNetworkStatus": 1,
|
|
|
"visionControllerNetworkStatus": 1,
|
|
|
"communicationData": {
|
|
|
"header": "KC",
|
|
|
"type": "E",
|
|
|
"data": {
|
|
|
"SRMNumber": "001",
|
|
|
"cmdName": "E1",
|
|
|
"taskId": "1ff",
|
|
|
"fromDirection": 2,
|
|
|
"fromColumn": 7,
|
|
|
"fromRow": 3,
|
|
|
"fromSeparation": 1,
|
|
|
"fromSide": 1,
|
|
|
"toSide": 1,
|
|
|
"toDirection": 1,
|
|
|
"toColumn": 8,
|
|
|
"toRow": 2,
|
|
|
"toSeparation": 1,
|
|
|
"warnCode": "",
|
|
|
"code": "123",
|
|
|
"trayCode": "1234",
|
|
|
"lotnum": "12342",
|
|
|
"typeNum": "000",
|
|
|
"quantity": 30,
|
|
|
"checkRlt": 1
|
|
|
}
|
|
|
}
|
|
|
},
|
|
|
{
|
|
|
"deviceName": "一号仓库动碰盘点系统",
|
|
|
"time": "2026-06-26 09:30:00",
|
|
|
"tofDevice01RunStatus": 1,
|
|
|
"tofDevice02RunStatus": 1,
|
|
|
"tofDevice03RunStatus": 1,
|
|
|
"tofDevice04RunStatus": 1,
|
|
|
"camera3dNetworkStatus": 1,
|
|
|
"camera3dErrorCode": 0,
|
|
|
"industrialCamera1ErrorCode": 0,
|
|
|
"industrialCamera1NetworkStatus": 1,
|
|
|
"industrialCamera2ErrorCode": 0,
|
|
|
"industrialCamera2NetworkStatus": 1,
|
|
|
"industrialCamera3ErrorCode": 0,
|
|
|
"industrialCamera3NetworkStatus": 1,
|
|
|
"industrialCamera4ErrorCode": 0,
|
|
|
"industrialCamera4NetworkStatus": 1,
|
|
|
"industrialCamera5ErrorCode": 0,
|
|
|
"industrialCamera5NetworkStatus": 1,
|
|
|
"industrialCamera6ErrorCode": 0,
|
|
|
"industrialCamera6NetworkStatus": 1,
|
|
|
"inventoryServerOnlineStatus": 1,
|
|
|
"communicationData": {
|
|
|
"header": "KC",
|
|
|
"type": "SC",
|
|
|
"data": {
|
|
|
"cmdName": "SC01",
|
|
|
"taskId": "1ff",
|
|
|
"code": "123",
|
|
|
"trayCode": "1234",
|
|
|
"lotnum": "12342",
|
|
|
"typeNum": "000",
|
|
|
"quantity": 30,
|
|
|
"checkRlt": "1"
|
|
|
}
|
|
|
}
|
|
|
}
|
|
|
]
|
|
|
}
|
|
|
```
|
|
|
|
|
|
### 顶层字段
|
|
|
|
|
|
| 字段 | 类型 | 说明 |
|
|
|
|------|------|------|
|
|
|
| code | int | 状态码，0=成功 |
|
|
|
| message | String | 状态描述 |
|
|
|
| data | Array | 库点数据数组，每项为一个库点的扁平 JSON 对象 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 库点一：非动碰盘点1号巷道盘点系统
|
|
|
|
|
|
| 所属设备 | 字段名 | 类型 | 说明 |
|
|
|
|----------|--------|------|------|
|
|
|
| 库点基本信息_名称 | deviceName | String | 库点名称 |
|
|
|
| 库点基本信息_采样时间 | time | String | 采样时间，格式 `yyyy-MM-dd HH:mm:ss` |
|
|
|
| 库点运行状态_运行状态 | warehouseRunStatus | int | 1=随行中，2=盘点中，3=无任务待机 |
|
|
|
| 库点运行状态_网络状态 | warehouseNetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 左侧扫码枪_网络状态 | leftScannerNetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 左侧扫码枪_扫码结果 | leftScannerScanResult | int | 1=成功，2=未识别 |
|
|
|
| 左深度扫码枪_网络状态 | leftDepthScannerNetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 左深度扫码枪_扫码结果 | leftDepthScannerScanResult | int | 1=成功，2=未识别 |
|
|
|
| 右侧扫码枪_网络状态 | rightScannerNetworkStatus | int | 1=在线，0=离线 |
|
|
|
| 右侧扫码枪_扫码结果 | rightScannerScanResult | int | 1=成功，2=未识别 |
|
|
|
| 右深度扫码枪_网络状态 | rightDepthScannerNetworkStatus | int | 1=在线，0=离线 |
|
|
|
| 右深度扫码枪_扫码结果 | rightDepthScannerScanResult | int | 1=成功，2=未识别 |
|
|
|
| 摄像头_网络状态 | cameraNetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 摄像头_错误代码 | cameraErrorCode | int | 见表《摄像头状态码》 |
|
|
|
| AP_网络状态 | apNetworkStatus | int | 1=在线，2=离线 |
|
|
|
| CPE_网络状态 | cpeNetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 视觉控制器_网络状态 | visionControllerNetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 通信_业务数据 | communicationData | Object | 堆垛机通信协议包，见下表 |
|
|
|
|
|
|
### communicationData 子字段
|
|
|
|
|
|
| 路径 | 类型 | 说明 |
|
|
|
|------|------|------|
|
|
|
| header | String | 发送方标识，昆船发送"KC" |
|
|
|
| type | String | 模式：A=心跳 B=任务模式 C=动作 D=报警 E=盘点 |
|
|
|
| data.SRMNumber | String | 巷道标识符 |
|
|
|
| data.cmdName | String | 指令名称：B1=开始随行；C1=取货到位；C2=取货完成；C3=送货到位；C4=送货完成；B2=随行完成；E1=开始盘点；SC01=站台盘点；SC02=站台盘点完成 |
|
|
|
| data.taskId | String | 任务单号 |
|
|
|
| data.fromSide | int | 来源侧：1=库内，2=库外 |
|
|
|
| data.fromDirection | int | 来源方向：1=左，2=右 |
|
|
|
| data.fromColumn | int | 来源列 |
|
|
|
| data.fromRow | int | 来源行 |
|
|
|
| data.fromSeparation | int | 来源深度：1=浅，2=深（双伸货架外侧时传2） |
|
|
|
| data.toSide | int | 目的侧：1=库内，2=库外 |
|
|
|
| data.toDirection | int | 目的方向：1=左，2=右 |
|
|
|
| data.toColumn | int | 目的列 |
|
|
|
| data.toRow | int | 目的行 |
|
|
|
| data.toSeparation | int | 目的深度：1=浅，2=深（双伸货架外侧时传2） |
|
|
|
| data.warnCode | String | type=D 时传，告警标识符，多个用逗号分隔 |
|
|
|
| data.code | String | 货架货物标识（空货物传""） |
|
|
|
| data.trayCode | String | 托盘标识（没托盘传""） |
|
|
|
| data.lotnum | String | 盘点批次（新批次会重置所有货位为未盘点） |
|
|
|
| data.typeNum | String | 品规编号 |
|
|
|
| data.quantity | int | 货物数量 |
|
|
|
| data.checkRlt | int | 盘点结果：0=盘点失败，1=盘点正确 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 库点二：一号仓库动碰盘点系统
|
|
|
|
|
|
| 所属设备 | 字段名 | 类型 | 说明 |
|
|
|
|----------|--------|------|------|
|
|
|
| 库点基本信息_名称 | deviceName | String | 库点名称 |
|
|
|
| 库点基本信息_采样时间 | time | String | 采样时间，格式 `yyyy-MM-dd HH:mm:ss` |
|
|
|
| TOF设备-01_运行状态 | tofDevice01RunStatus | int | 1=在线，2=离线 |
|
|
|
| TOF设备-02_运行状态 | tofDevice02RunStatus | int | 1=在线，2=离线 |
|
|
|
| TOF设备-03_运行状态 | tofDevice03RunStatus | int | 1=在线，2=离线 |
|
|
|
| TOF设备-04_运行状态 | tofDevice04RunStatus | int | 1=在线，2=离线 |
|
|
|
| 3D相机_网络状态 | camera3dNetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 3D相机_故障代码 | camera3dErrorCode | int | 见表《3D相机状态码》 |
|
|
|
| 1号工业相机_故障代码 | industrialCamera1ErrorCode | int | 见表《工业相机状态码》 |
|
|
|
| 1号工业相机_网络状态 | industrialCamera1NetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 2号工业相机_故障代码 | industrialCamera2ErrorCode | int | 见表《工业相机状态码》 |
|
|
|
| 2号工业相机_网络状态 | industrialCamera2NetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 3号工业相机_故障代码 | industrialCamera3ErrorCode | int | 见表《工业相机状态码》 |
|
|
|
| 3号工业相机_网络状态 | industrialCamera3NetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 4号工业相机_故障代码 | industrialCamera4ErrorCode | int | 见表《工业相机状态码》 |
|
|
|
| 4号工业相机_网络状态 | industrialCamera4NetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 5号工业相机_故障代码 | industrialCamera5ErrorCode | int | 见表《工业相机状态码》 |
|
|
|
| 5号工业相机_网络状态 | industrialCamera5NetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 6号工业相机_故障代码 | industrialCamera6ErrorCode | int | 见表《工业相机状态码》 |
|
|
|
| 6号工业相机_网络状态 | industrialCamera6NetworkStatus | int | 1=在线，2=离线 |
|
|
|
| 盘点服务器_在线状态 | inventoryServerOnlineStatus | int | 1=在线，0=离线 |
|
|
|
| 通信_站台业务数据 | communicationData | Object | 站台盘点通信协议包，见下表 |
|
|
|
|
|
|
### communicationData 子字段
|
|
|
|
|
|
| 路径 | 类型 | 说明 |
|
|
|
|------|------|------|
|
|
|
| header | String | 发送方标识，昆船发送"KC" |
|
|
|
| type | String | 模式：SC=站台盘点 |
|
|
|
| data.cmdName | String | 指令名称：SC01=站台盘点；SC02=站台盘点完成 |
|
|
|
| data.taskId | String | 任务号 |
|
|
|
| data.code | String | 条码 |
|
|
|
| data.trayCode | String | 托盘码 |
|
|
|
| data.lotnum | String | 批次号 |
|
|
|
| data.typeNum | String | 品规编号 |
|
|
|
| data.quantity | int | 货物数量 |
|
|
|
| data.checkRlt | String | 盘点结果：0=盘点失败，1=盘点正确 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 注意事项
|
|
|
|
|
|
1. 响应顶层 `data` 为数组，每项为一个库点的扁平 JSON 对象
|
|
|
2. 每个库点对象中，设备状态直接作为字段，不再嵌套 `devices` 数组
|
|
|
3. 各库点共享同一个 `time` 采样时间
|
|
|
4. 设备状态字段统一为 **int** 类型（1=在线/正常，0/2=离线/异常，视具体字段而定）
|
|
|
5. 通信业务数据为嵌套 **Object**，包含堆垛机/站台的完整协议包
|
|
|
6. 不同库点的字段集合不同（非动碰库点有扫码枪和堆垛机通信，动碰盘点系统有TOF和工业相机和站台通信）
|
|
|
7. 扫码枪分为普通扫码枪和深度扫码枪，左右各两个，共4个扫码枪
|
|
|
|
|
|
---
|
|
|
|
|
|
> 版本: v3.0 | 更新: 2026-07-03
|