yfdoc/zh-cn/xy2/xy2.md

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

简述

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

通信描述

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

对接说明

设备数据说明

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

设备数据报文结构

设备数据

{
  "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	警告信息

设备击杀计数

{
  "pest": 1,
  "imei": "e20210106947931",
  "protocoltype": 3
}

字段说明

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