物联网开发文档

当前接口仅适用于version为17且appVersionCode>=9的虫情设备，设备运行状态每10分钟上报一次

# 功能详情

根据设备号获取设备运行状态，包括诱虫灯、雨水分离仓、杀虫仓、烘干仓、震动电机、补光灯、毛刷等硬件开关状态，以及DI雨雪、DI光敏检测结果和加热仓温度、光敏传感器电压

# 请求地址和方法

  • 请求地址

https://www.sdzhiot.top/api/v3/pestStation/deviceStatus

  • 请求方法

GET

# 请求参数说明

  • 请求参数
字段名 字段类型 字段说明 是否必须
sno String 设备号 Y

# 样例输入

/api/v3/pestStation/deviceStatus?sno=C19E0E39D99B

# 返回data字段说明

字段名 字段类型 字段说明
reportTime Long 设备状态上报时间（毫秒时间戳），设备尚未上报过时为null
values Object 各状态项集合，key为字段枚举名

其中values内每个状态项的数据结构说明如下

字段名 字段类型 字段说明
value Float 数值（开关状态0/1，温度单位℃，电压单位V；设备端读取失败时为null）
name String 状态项中文名称
unit String 单位（开关状态量为空字符串）

values包含的状态项如下

枚举名 名称 说明
LIGHT_TRAP_STATUS 诱虫灯状态 0关闭 1开启
RAIN_SEPARATOR_STATUS 雨水分离仓 0关闭 1开启
KILL_HEATER_STATUS 杀虫仓加热状态 0关闭 1开启
KILL_FLAP_STATUS 杀虫仓翻板状态 0关闭 1开启
DRY_HEATER_STATUS 烘干仓加热状态 0关闭 1开启
DRY_FLAP_STATUS 烘干仓翻板状态 0关闭 1开启
VIBRATION_STATUS 震动电机状态 0关闭 1开启
FILL_LIGHT_STATUS 补光灯状态 0关闭 1开启
BRUSH_STATUS 毛刷清虫状态 0关闭 1开启
DI_RAIN_SNOW DI雨雪 0无雨雪 1检测到雨雪
DI_LIGHT_SENSOR DI光敏 0无光照 1检测到光照
HEATER_TEMPERATURE 加热仓温度 单位℃
LIGHT_VOLTAGE 光敏传感器模拟电压 单位V

# 样例输出

{
    "code": 0,
    "data": {
        "reportTime": 1787037003575,
        "values": {
            "LIGHT_TRAP_STATUS": { "value": 0, "name": "诱虫灯状态", "unit": "" },
            "RAIN_SEPARATOR_STATUS": { "value": 0, "name": "雨水分离仓", "unit": "" },
            "KILL_HEATER_STATUS": { "value": 0, "name": "杀虫仓加热状态", "unit": "" },
            "KILL_FLAP_STATUS": { "value": 0, "name": "杀虫仓翻板状态", "unit": "" },
            "DRY_HEATER_STATUS": { "value": 0, "name": "烘干仓加热状态", "unit": "" },
            "DRY_FLAP_STATUS": { "value": 0, "name": "烘干仓翻板状态", "unit": "" },
            "VIBRATION_STATUS": { "value": 0, "name": "震动电机状态", "unit": "" },
            "FILL_LIGHT_STATUS": { "value": 0, "name": "补光灯状态", "unit": "" },
            "BRUSH_STATUS": { "value": 0, "name": "毛刷清虫状态", "unit": "" },
            "DI_RAIN_SNOW": { "value": 1, "name": "DI雨雪", "unit": "" },
            "DI_LIGHT_SENSOR": { "value": 0, "name": "DI光敏", "unit": "" },
            "HEATER_TEMPERATURE": { "value": 65, "name": "加热仓温度", "unit": "°C" },
            "LIGHT_VOLTAGE": { "value": 3.2, "name": "光敏传感器模拟电压", "unit": "V" }
        }
    },
    "msg": "操作成功"
}

# 返回码

返回码 返回消息 说明
0 操作成功 请求成功
500 服务器错误 服务端异常
10001 参数为空或格式不正确 参数错误
10002 appKey不存在 确认appKey是否正确
10004 设备版本不支持此功能 设备version不是17
10013 设备APP版本过低，请升级后重试 设备appVersionCode低于9，无状态上报能力
40001 设备不存在或您没有当前设备权限 设备不属于当前账户

← 获取杀虫灯设备列表 →