# 性诱测报与服务端交互通讯细节

## 简述

本文档主要用于阐述性诱测报与服务端进行交互的通讯细节。

## 通信描述

对接采用 HTTP 协议，由接收方写接口来接收 HTTP POST 数据（需从 request 的 body（字节流类型）中取数据，取到之后进行 JSON 解析）。

## 对接说明

### 设备数据说明

1. **设备数据分为两种**：
   - **第一种（设备数据）**：30 分钟上传一次。
   - **第二种（击杀计数）**：只要捕获到害虫就会触发上传一次。
2. **设备数据包含**：设备号、环境温湿度、工作状态、电压等。
3. **数据格式不可变**：设备数据格式不可变，不能按接收方增加或者减少字段，如有需求请联系销售经理。
4. **接口安全**：可以针对传输方 IP 做限制，非传输方 IP 不允许调用接口（传输方 IP 可以联系对接人员提供）。
5. **设备离线问题**：如果未及时收到 30 分钟上传一次的设备数据，说明设备离线。
6. **接口设置**：由我们这边进行配置，您只需要把接口发给对接人员就可以了。

## 设备数据报文结构

### 设备数据

```json
{
  "b_v": "23.5",
  "b_c": "23.7",
  "p_v": "23.8",
  "p_c": "23.9",
  "uptime": "2021-05-25 17:41:26",
  "at": "35",
  "ah": "23",
  "warn": "",
  "imei": "e20210106947931",
  "protocoltype": 2
}
```
字段说明  

| 字段名   | 描述                     |
| -------- | ------------------------ |
| imei     | 通讯板唯一 ID            |
| uptime   | 数据采集时间             |
| protocoltype | 数据类型 2：设备数据 |
| at       | 环境温度                 |
| ah       | 环境湿度                 |
| b_v      | 电池电压                 |
| b_c      | 电池电流                 |
| p_v      | 太阳能板电压             |
| p_c      | 太阳能板电流             |
| warn     | 警告信息                 |
设备击杀计数  
```json
{
  "pest": 1,
  "imei": "e20210106947931",
  "protocoltype": 3
}
```
字段说明  

| 字段名       | 描述                     |
| ------------ | ------------------------ |
| imei         | 通讯板唯一 ID            |
| protocoltype | 数据类型 3：杀虫计数     |
| pest         | 击杀计数                 |