设备类型

香薰机 S-AC-WB-AD-090-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/Aromatherapy/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "dayOfWeek": 0,//周几
      "alarmSound": 0,//告警声音 0关闭 1开启（下发参数）
      "reset": 0, //重置复位 0保持 1执行（下发参数）
      "sprayTest": 0, //测试喷香 0保持 1执行（下发参数）
      "sprayCount": 0, // 喷香累计次数
      "shellStatus": 0, // 外壳状态 0关盖 1开盖
      "remain": 0, // 余量 0 0% 1 >0% 2 >30% 3 >60% 4 >90%
      "workStatus": 0, // 工作状态 0停用 1运行（下发参数）
      "sprayMode": 0, // 喷香模式 0感应 1定时（下发参数）
      "weekPlans": [// 周计划 可设置最多56组（下发参数）
        {
          "isEnabled": true,//是否启用
          "planOrder": 0,//计划排序
          "sprayDurationOfOnce": 0, // 每次喷香时长 秒（下发参数）
          "spraySpan": 0, // 喷香间隔 分钟（下发参数）
          "startTime": 0, // 开始时间 格式：07：50为0750即750（下发参数）
          "endTime": 0, // 结束时间 格式：23：59为2359（下发参数）
          "autoSprayDate": 0// 自动喷香日期 采用7位数表示周一至周日占用情况，如1111111表示每天、1100000表示周一和周二、0000011即11则表示周六和周日（下发参数）
        }
      ]
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/Aromatherapy/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "reset": 0,
    "sprayTest": 0,
    "alarmSound": 0,
    "workStatus": 0,
    "sprayMode": 0,
    "sprayDurationOfOnce": 0,
    "spraySpan": 0,
    "weekPlans": [
      {
        "startTime": 0,
        "endTime": 0,
        "autoSprayDate": 0
      }
    ]
  },
  "accessId": "string", //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每2小时	心跳	无
	每1分钟	检测电池电压	首次出现低电
操作触发	每次	开机	读取设备的全部状态参数
	每次	开盖/关盖	设备状态有变更
	每次	设置单次喷香时长/浓度	功能参数有变更
	每次	设置喷香间隔时间	功能参数有变更
	每次	设置自动喷香模式	功能设置有变更
	每次	设置自动喷香计划	功能参数有变更
	常供电时，每1次； 电池供电时，每5次；	蓝牙APP试喷	统计数据有变更
	常供电时，每1次； 电池供电时，每5次；	感应喷香	统计数据有变更
	常供电时，每1次； 电池供电时，每5次；	自动喷香	统计数据有变更
	每次	开启/关闭声音提示	功能设置有变更
状态触发	每次	喷香完成时，自动检测余量	余量有变化

香薰机 S-AC-WB-ZM-090-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/Aromatherapy/ZM/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "dayOfWeek": 0,//周几
      "alarmSound": 0,//告警声音 0关闭 1开启（下发参数）
      "reset": 0, //重置复位 0保持 1执行（下发参数）
      "sprayTest": 0, //测试喷香 0保持 1执行A 2执行B（下发参数）
      "sprayCount": 0, // 喷香累计次数 A
      "sprayCountB": 0, // 喷香累计次数 B
      "BrightMode": 0, // 屏幕亮度模式 0是光感自动亮度 1是自定义亮度
      "BrightValue": 0, // 当前亮度值
      "Tem": 0, // 环境温度
      "Hum": 0, // 环境湿度 0-99 %
      "remain": 0, // 余量 1是 B缺液 2是 A缺液 3是都不缺 0是都缺液
      "workStatus": 0, // 工作状态 0停用 1运行（下发参数）
      "sprayMode": 0, // 喷香模式 0感应 1定时（下发参数）
      "weekPlans": [// 周计划 可设置最多56组（下发参数）
        {
          "isEnabled": true,//是否启用
          "planOrder": 0,//计划排序
          "sprayDurationOfOnce": 0, // 每次喷香时长 秒（下发参数）
          "spraySpan": 0, // 喷香间隔 分钟（下发参数）
          "atomizer": 0, // 雾化片 0是雾化位A（默认），1是雾化位B
          "startTime": 0, // 开始时间 格式：07：50为0750即750（下发参数）
          "endTime": 0, // 结束时间 格式：23：59为2359（下发参数）
          "autoSprayDate": 0// 自动喷香日期 采用7位数表示周一至周日占用情况，如1111111表示每天、1100000表示周一和周二、0000011即11则表示周六和周日（下发参数）
        }
      ]
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/Aromatherapy/ZM/SendSet

请求方式: POST

请求数据:

{
  "sendData": {
    "sendProcess": 0,
    "batchSyncRoomId": 0,
    "batchSyncSpaceId": 0,
    "deviceId": 0,
    "reset": 0,
    "sprayTest": 0,
    "alarmSound": 0,
    "workStatus": 0,
    "sprayMode": 0,
    "sprayDurationOfOnce": 0,
    "spraySpan": 0,
    "weekPlans": [
      {
        "isEnabled": true, //该计划是否启用
        "startTime": 0,
        "endTime": 0,
        "autoSprayDate": 0,
        "atomizer": 0
      }
    ],
    "oils": [
      {
        "isEnabled": true, //精油是否启用
        "oilName": "白茶香" //设置的精油名称
      }, //A雾化位
      {
        "isEnabled": true,
        "oilName": "oilName"
      } //B雾化位
    ]
  },
  "accessId": "string",
  "accessSecret": "string"
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

纸巾盒 S-PS-WB-PD-016-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/InductionPaperBox/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "useLength": 0, //已使用纸量 厘米
      "useCount": 0, //已使用次数
      "useRoll": 0, //已使用卷数
      "rollLength": 0, //卷纸长度
      "hwProtocol": 0, //硬件协议（可下发）
      "shellStatus": 0, //外壳状态 0关盖 1开盖
      "useMode": 0, //使用方式 0感应 1自动（可下发）
      "paperTest": 0, //蓝牙 测试出纸（可下发）
      "gearLength": 0, //挡位长度 25cm 35cm 45cm（可下发）
      "priority": 0, //优先级 0云端 1设备（可下发）
      "remain": 0, //余量 0 无纸 1少纸 2有纸
      "grantStatus": 0, //授权状态 0 关闭 1 开启（可下发）
      "applyGrant": 0, //授权申请 0 关闭 1 申请
      "workStatus": 0, //工作状态 0停用 1运行（可下发）
      "faultCode": 0, //故障 0无故障，1切刀马达故障，2滚筒马达故障，3出纸检测故障 4卡纸故障
      "reset": 0 //重置复位 0保持 1执行
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/InductionPaperBox/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "rollLength": 0,
    "hwProtocol": 0,
    "useMode": 0,
    "paperTest": 0,
    "gearLength": 0,
    "priority": 0,
    "grantStatus": 0,
    "applyGrant": 0,
    "workStatus": 0,
    "remainThreshold": 0,
    "reset": 0
  },
  "accessId": "string", //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每2小时	心跳	无
操作触发	每次	给设备上电	读取设备的全部状态参数
	每次	开盖/关盖	设备状态有变更
	每次	设置出纸档位/出纸长度	功能参数有变更
	每5次	蓝牙APP出纸	统计数据有变更
	每5次	感应出纸	统计数据有变更
状态触发	每次	出纸完成时，自动检测卷纸余量	卷纸余量有变更
	每次	出纸完成时，自动检测断纸状态	出现断纸
	每次	出纸（完成）时，自动检测故障	出现故障
	每次	出纸完成时，上报数据或心跳时，同步检测电池电压	首次出现低电

纸巾盒 S-PS-WB-PD-R16-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/InductionPaperBox/Rfid/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "useLength": 0, //已使用纸量 厘米
      "useCount": 0, //已使用次数
      "useRoll": 0, //已使用卷数
      "rollLength": 0, //卷纸长度
      "hwProtocol": 0, //硬件协议（可下发）
      "shellStatus": 0, //外壳状态 0关盖 1开盖
      "useMode": 0, //使用方式 0感应 1自动（可下发）
      "paperTest": 0, //蓝牙 测试出纸（可下发）
      "gearLength": 0, //挡位长度 25cm 35cm 45cm（可下发）
      "priority": 0, //优先级 0云端 1设备（可下发）
      "remain": 0, //余量 0 无纸 1少纸 2有纸
      "grantStatus": 0, //授权状态 0 关闭 1 开启（可下发）
      "applyGrant": 0, //授权申请 0 关闭 1 申请
      "workStatus": 0, //工作状态 0停用 1运行（可下发）
      "faultCode": 0, //故障 0无故障，1切刀马达故障，2滚筒马达故障，3出纸检测故障 4卡纸故障
      "reset": 0, //重置复位 0保持 1执行
      "rfid": "string" //rfid编号
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/InductionPaperBox/Rfid/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "rollLength": 0,
    "hwProtocol": 0,
    "useMode": 0,
    "paperTest": 0,
    "gearLength": 0,
    "priority": 0,
    "grantStatus": 0,
    "applyGrant": 0,
    "workStatus": 0,
    "remainThreshold": 0,
    "reset": 0
  },
  "accessId": "string", //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每2小时	心跳	无
操作触发	每次	给设备上电	读取设备的全部状态参数
	每次	开盖/关盖	设备状态有变更
	每次	设置出纸档位/出纸长度	功能参数有变更
	每5次	蓝牙APP出纸	统计数据有变更
	每5次	感应出纸	统计数据有变更
状态触发	每次	出纸完成时，自动检测卷纸余量	卷纸余量有变更
	每次	出纸完成时，自动检测断纸状态	出现断纸
	每次	出纸（完成）时，自动检测故障	出现故障
	每次	出纸完成时，上报数据或心跳时，同步检测电池电压	首次出现低电
	每次	关盖完成时，自动读取电子标签	出现新的电子标签ID

纸巾盒 S-PS-NB-PD-G16-9

同S-PS-WB-PD-R16-9调用。

纸巾盒 S-PS-WB-ZM-063-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/InductionPaperBox/ZM/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "useLength": 0, //已使用纸量 厘米
      "useCount": 0, //已使用次数
      "useRoll": 0, //已使用卷数
      "rollLength": 0, //卷纸长度
      "hwProtocol": 0, //硬件协议（可下发）
      "shellStatus": 0, //外壳状态 0关盖 1开盖
      "lockStatus": 1, //锁状态 0关锁 1开锁
      "useMode": 0, //使用方式 0感应 1自动（可下发）
      "paperTest": 0, //蓝牙 测试出纸（可下发）
      "gearLength": 0, //挡位长度 25cm 35cm 45cm（可下发）
      "remain": 0, //余量 0 无纸 1少纸 2有纸
      "alarmSound": 0,//告警声音 0关闭 1开启（下发参数）
      "workStatus": 0, //工作状态 0停用 1运行（可下发）
      "faultCode": 0, //故障 0是无故障，bit0=1是红外进纸故障，bit1=1出纸微动开关故障，bit2=1滚筒马达故障，bit3=1是断纸
      "rfid": "string", //rfid编号
      "version": 17, //固件版本号 实际版本除10 即 1.7版本
      "beatSpan": 120, //心跳间隔 秒
      "powerMode": 0, //电源模式 0 直流电 1交流电
      "voltage": 583 //电压 伏 实际电压除100 即 5.83V
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/InductionPaperBox/ZM/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "batchSyncRoomId": 0, //需要批量同步的房间ID（单设备忽略该字段）
    "batchSyncSpaceId": 0, //需要批量同步的家庭ID（单设备忽略该字段）
    "deviceId": 0, //设备ID
    "rollLength": 0, 
    "hwProtocol": 0, 
    "lockStatus": 0, 
    "useMode": 0,
    "paperTest": 0,
    "gearLength": 0,
    "workStatus": 0,
    "remainThreshold": 0, //余量提醒阈值 即>=该值推送报警
    "alarmSound": 0,
    "cleanTipStatus": 0, //清洁提醒开关 0关闭 1开启
    "cleanTipCount": 0, //清洁提醒次数 即达到次数推送提醒消息 提醒后会重置计数
  },
  "accessId": "string",
  "accessSecret": "string"
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每2小时	心跳	无
操作触发	每次	给设备上电	读取设备的全部状态参数
	每次	开锁/关锁	设备状态有变更
	每次	设置出纸长度	功能参数有变更
	每次	设置出纸模式	功能设置有变更
	每次	蓝牙APP出纸	统计数据有变更
	常供电时，每1次； 电池供电时，每5次；	感应出纸	统计数据有变更
	常供电时，每1次； 电池供电时，每5次；	自动出纸	统计数据有变更
	每次	开启/关闭声音提示	功能设置有变更
状态触发	每次	出纸完成时，自动检测断纸状态	出现断纸
	每次	出纸完成时，自动统计每卷纸的出纸长度	卷纸已用完
	每次	出纸完成时，自动检测卷纸余量变化	卷纸余量有变化
	每次	出纸（完成）时，自动检测故障	出现故障
	每次	出纸完成时，上报数据或心跳时，同步检测电池电压	首次出现低电

纸巾盒 S-PS-WB-ZM-016-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/InductionPaperBox/ZM016/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "useLength": 0, //已使用纸量 厘米
      "useCount": 0, //已使用次数
      "useRoll": 0, //已使用卷数
      "shellStatus": 0, //外壳状态 0关盖 1开盖
      "lockStatus": 1, //锁状态 0关锁 1开锁
      "useMode": 0, //使用方式 0感应 1自动（可下发）
      "paperTest": 0, //蓝牙 测试出纸（可下发）
      "gearLength": 0, //挡位长度 25cm 35cm 45cm（可下发）
      "remain": 0, //余量 0 无纸 1少纸 2有纸
      "remainThreshold": 0, //余量阈值 0是A点提示，1是B点提示（可下发）
      "alarmSound": 0, //告警声音 0关闭 1开启（下发参数）
      "workStatus": 0, //工作状态 0停用 1运行（可下发）
      "faultCode": 0, //故障 0是无故障，bit0=1是红外进纸故障，bit1=1红外出纸故障，bit2=1滚筒马达故障，bit3=1切刀马达故障，bit4=1断纸
      "rfid": "string", //rfid编号
      "version": 17, //固件版本号 实际版本除10 即 1.7版本
      "beatSpan": 120, //心跳间隔 秒
      "powerMode": 0, //电源模式 0 直流电 1交流电
      "voltage": 583 //电压 伏 实际电压除100 即 5.83V
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/InductionPaperBox/ZM016/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "batchSyncRoomId": 0, //需要批量同步的房间ID（单设备忽略该字段）
    "batchSyncSpaceId": 0, //需要批量同步的家庭ID（单设备忽略该字段）
    "deviceId": 0, //设备ID
    "rollLength": 0, 
    "hwProtocol": 0, 
    "lockStatus": 0, 
    "useMode": 0,
    "paperTest": 0,
    "gearLength": 0,
    "workStatus": 0,
    "remainThreshold": 0, //余量提醒阈值 即>=该值推送报警
    "alarmSound": 0,
    "cleanTipStatus": 0, //清洁提醒开关 0关闭 1开启
    "cleanTipCount": 0, //清洁提醒次数 即达到次数推送提醒消息 提醒后会重置计数
  },
  "accessId": "string",
  "accessSecret": "string"
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每2小时	心跳	无
操作触发	每次	给设备上电	读取设备的全部状态参数
	每次	开锁/关锁	设备状态有变更
	每次	设置出纸长度	功能参数有变更
	每次	设置出纸模式	功能设置有变更
	每次	蓝牙APP出纸	统计数据有变更
	常供电时，每1次； 电池供电时，每5次；	感应出纸	统计数据有变更
	常供电时，每1次； 电池供电时，每5次；	自动出纸	统计数据有变更
状态触发	每次	出纸完成时，自动检测卷纸余量变化	卷纸余量有变化
	每次	出纸完成时，自动检测断纸状态	出现断纸
	每次	出纸（完成）时，自动检测故障	出现故障
	每次	出纸完成时，上报数据或心跳时，同步检测电池电压	首次出现低电

纸巾盒模组 S-PS-WB-MD-001-0

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/PaperBoxMoudle/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "remain": 0 //余量 0缺纸 1， 2， 3， 4 100%满纸 
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/PaperBoxMoudle/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "remainThreshold": 0 //余量阈值 0 默认 C点 1 B点 2 A点
  },
  "accessId": "string", //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每24小时	心跳	无
	每5分钟	自动检测卷纸余量（卷纸余量 ≥ C点）	卷纸余量有变更
	每1分钟	自动检测卷纸余量（卷纸余量＜C点）	卷纸余量有变更
操作触发	每次	开机	读取设备的全部状态参数
状态触发	每次	检测卷纸余量时，同步检测电池电压	首次出现低电

纸巾盒支架模组 S-PS-WB-MD-002-0

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/PaperBoxMoudle/002/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    {
      "Remain": 0,// 余量 0是无纸，1是A有纸，2是B有纸
      "RemainThreshold": 0,// 余量阈值 0是A点提示，1是B点提示（下发参数）
      "PaperChange": 0,// 纸巾更换 0是无，1是已换纸
      "WorkStatus": 1,// 工作状态 0停用 1运行（下发参数）
      "CreateTime": "2024-04-12 18:18:25",
      "DtuNo": null,
      "Version": 12,
      "BeatSpan": 24,//心跳间隔 24小时
      "PowerMode": 1,
      "Voltage": 397
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/PaperBoxMoudle/002/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "remainThreshold": 0, //余量阈值 0 默认 A点 1 B点
    "workstatus": 1, //工作状态 0停用 1运行
  },
  "accessId": "string", //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每24小时	心跳	无
	每5分钟	自动检测卷纸余量（卷纸余量 ≥ B点）	卷纸余量有变更
	每1分钟	自动检测卷纸余量（卷纸余量＜B点）	卷纸余量有变更
	每10分钟	自动检测电池电压（电池电压 ≥ 3.4v）	首次出现低电
	每1分钟	自动检测电池电压（电池电压＜3.4v）	首次出现低电
操作触发	每次	开机	读取设备的全部状态参数

干手器 S-DS-WB-HD-185-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/HandDryer/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "totalDryCount": 0, // 累计干手次数
      "dryDurationOfOnce": 0, // 每次干手时长 秒
      "powerDurationOfOnce": 0, // 每次干手耗电量 瓦时
      "hwProtocol": 0, // 数据通信方式 0 WIFI 1 FSK
      "tem": 0, // 环境温度 -50~80 ℃
      "dryMode": 0, // 干手模式 0 自动风 1 常温 2 热风
      "windSpeed": 0, // 可调风速 100% 40%-100% 步进 6%
      "heatingPower": 0, // 可调加热功率 挡位 1 2 3 4 5 越来越大
      "autoSterilize": 0, // 自动除菌功能 0 关闭 1开启
      "sterilizeResult": 0, // 杀菌结果 0 没有 1 杀菌成功 2 杀菌失败
      "lightStatus": 0, // 灯光状态 0 关闭 1 雷达感应 2 红外感应 3 常亮
      "lightEffect": 0, // 灯光效果 0 常亮 1 同步呼吸 2 单灯呼吸 三灯流水 3 单灯渐变 三灯跑马
      "lightColor": 0, // 灯光颜色 0 默认 1 自定义
      "lightColor_RGB": "string", // RGB色 255,255,255
      "fullColor": 0, // 全彩 0 关闭 1 开启
      "waterStatus": 0, // 水满状态 0 正常 1 满载
      "filterStatus": 0, // 滤芯状态 0 正常 1 过期
      "faultCode": 0, // 故障 0无故障，bit0 风机马达故障-电流偏大，bit1 风机马达故障-电流偏小，bit2 发热丝故障-电流偏大，bit3 发热丝故障-电流偏小， bit4 环境高温异常
      "workStatus": 0 // 工作状态 0停用 1运行
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/HandDryer/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "dryMode": 0,
    "windSpeed": 0,
    "autoSterilize": 0,
    "lightStatus": 0,
    "lightColor": 0,   
    "lightColor_RGB": "string",
    "fullColor": 0,
    "lightEffect": 0,
    "workStatus": 0
  },
  "accessId": "string", //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每2小时	心跳	无
	每20分钟	检测环境温度	环境温度有变化
	每24小时	连续1小时检测到无人时，开始自动杀菌	自动杀菌成功（满30分钟）
	实时	检测水槽的水位	出现水满状态
操作触发	每次	给设备上电	读取设备的全部状态参数
	每次	设置干手模式	功能设置有变更
	每次	设置风速模式	功能参数有变更
	每次	常温风/热风干手	统计数据有变更
	每5000次	常温风/热风干手	滤芯寿命过期
	每次	开启/关闭自动杀菌	功能设置有变更
	每次	设置灯光方式	功能设置有变更
状态触发	每次	开始干手时，检测环境温度	环境温度有变化
	每次	干手时，检测故障	出现故障

皂液器 S-SC-WB-SD-055-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/SoapDispenser/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "useCount": 6947300, //累计使用次数
      "shellStatus": 0, //外壳状态 0关盖 1开盖
      "autoDetect": 0, //自适应感应距离 0 保持 1 开始
      "detectDistance": 0, // 感应距离
      "remain": 0, //余量 0 余量不足 >0 充足
      "workStatus": 1, // 工作状态 0停用 1运行
      "faultCode": 0,//故障码 0无故障，1马达故障
      "createTime": "2023-11-30 10:37:39", //创建时间
      "dtuNo": null, //网关编号（独立设备不含网关）
      "version": 17, //固件版本号 实际版本除10 即 1.7版本
      "beatSpan": 120, //心跳间隔 秒
      "powerMode": 0, //电源模式 0 直流电 1交流电
      "voltage": 583 //电压 伏 实际电压除100 即 5.83V
    },
    "categoryId": 501 //设备类型
  },
  "message": "请求成功", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/SoapDispenser/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "batchSyncRoomId": 0, //需要批量同步的房间ID（单设备忽略该字段）
    "batchSyncSpaceId": 0, //需要批量同步的家庭ID（单设备忽略该字段）
    "deviceId": 0, //设备ID
    "autoDetect": 0, //自适应感应距离
    "workStatus": 0, //工作状态 0停用 1运行
    "cleanTipStatus": 0, //清洁提醒开关 0关闭 1开启
    "cleanTipCount": 0, //清洁提醒次数 即达到次数推送提醒消息 提醒后会重置计数
    "specs": 0, //规格 0 瓶装bottled 1 袋装 InBags
    "capacity": 0, //袋装参数 容量 ML
    "availableCount": 0 //袋装参数 可用次数
  },
  "accessId": "string",  //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

皂液器 S-SC-WB-SD-056-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/SoapDispenser/056/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "totalUseCount": 0, // 累计出液次数
      "onOffStatus": 1, // 开关机状态 0关机 1开机（可下发）
      "shellStatus": 0, // 盖子状态 0关盖 1开盖
      "faultCode": 1, // 故障 0是无故障，1马达故障
      "statisticMode": 0, // 余量统计方式 0根据传感器余量检测 1根据设定规格递减（可下发）
      "remain": 0, // 余量状态 0 无余量，1 小于20%，2 20-50%，3 50%-100%，4 大于>100%
      "bottleTotalCount": 0, // 当前瓶总出液次数（可下发）
      "bottleRemainCount": 0, // 当前瓶剩余出液次数
      "workStatus": 1, // 工作状态 0停用 1运行（可下发）
      "useTimeRecords": [ // 使用时间记录
        "2024-03-04 13:38:00",
        "2024-03-04 13:38:18",
        "2024-03-04 13:38:24",
        "2024-03-04 13:38:29",
        "2024-03-04 13:38:34",
        "2024-03-04 13:38:37",
        "2024-03-04 13:38:43",
        "2024-03-04 13:38:52",
        "2024-03-04 13:38:57",
        "2024-03-04 13:40:15"
      ],
      "createTime": "2024-03-04 13:41:30", //创建时间
      "dtuNo": null, //网关编号（独立设备不含网关）
      "version": 11, //固件版本号 实际版本除10 即 1.7版本
      "beatSpan": 48, //心跳间隔 秒
      "powerMode": 1, //电源模式 0 直流电 1交流电
      "voltage": 600 //电压 伏 实际电压除100 即 5.83V
    },
    "categoryId": 501 //设备类型
  },
  "message": "请求成功", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/SoapDispenser/056/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "batchSyncRoomId": 0, //需要批量同步的房间ID（单设备忽略该字段）
    "batchSyncSpaceId": 0, //需要批量同步的家庭ID（单设备忽略该字段）
    "deviceId": 0, //设备ID
    "goodsId": 0, //关联耗材ID
    "onOffStatus": 0,
    "cleanTipStatus": 0, //清洁提醒状态 0 关闭 1开启
    "cleanTipCount": 0, //清洁提醒间隔次数 如设置50则使用次数累计到50推送清洁提醒
    "workStatus": 0
  },
  "accessId": "string",  //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每2小时	心跳	无
操作触发	每次	上电开机	读取设备的全部状态参数
	每次	开启/关闭待机	设备状态有变更
	每次	开盖/关盖	设备状态有变更
	每次	通过蓝牙APP设置功能参数	功能设置/参数有变更
	每10次	感应出液(电池供电)	统计数据有变更
	每次	感应出液(常供电)	统计数据有变更
状态触发	每次	出液开始后3s内，自动检测马达运行情况	出现马达故障
	每次	出液完成时，自动检测余量	余量有变化
	每次	在计算余量的功能模式下	出现缺液警报,或剩余出液次数为0

皂液器 M-EM-WB-SD-01-B(ODM-EM)

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/SoapDispenser/ODM/EM/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "bottleUseCount": 0, // 当前瓶实际出液次数
      "totalUseBottle": 0, // 累计使用瓶数
      "onOffStatus": 1, // 开关机状态 0关机 1开机（可下发）
      "shellStatus": 0, // 盖子状态 0关盖 1开盖
      "detectDistance": 0, // 有效感应距离 默认是约7cm位置处，可调范围0%-100%可调检测距离（PWM参数 可下发）
      "faultCode": 1, // 故障 0是无故障，1马达故障
      "statisticMode": 0, // 余量统计方式 0根据传感器余量检测 1根据设定规格递减（可下发）
      "remain": 0, // 余量状态 0 无余量，1 小于20%，2 20-50%，3 50%-100%，4 大于>100%
      "bottleTotalCount": 0, // 当前瓶总出液次数（可下发）
      "bottleRemainCount": 0, // 当前瓶剩余出液次数
      "workStatus": 1, // 工作状态 0停用 1运行（可下发）
      "useTimeRecords": [ // 使用时间记录
        "2024-03-04 13:38:00",
        "2024-03-04 13:38:18",
        "2024-03-04 13:38:24",
        "2024-03-04 13:38:29",
        "2024-03-04 13:38:34",
        "2024-03-04 13:38:37",
        "2024-03-04 13:38:43",
        "2024-03-04 13:38:52",
        "2024-03-04 13:38:57",
        "2024-03-04 13:40:15"
      ],
      "createTime": "2024-03-04 13:41:30", //创建时间
      "dtuNo": null, //网关编号（独立设备不含网关）
      "version": 11, //固件版本号 实际版本除10 即 1.7版本
      "beatSpan": 48, //心跳间隔 秒
      "powerMode": 1, //电源模式 0 直流电 1交流电
      "voltage": 600 //电压 伏 实际电压除100 即 5.83V
    },
    "categoryId": 501 //设备类型
  },
  "message": "请求成功", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/SoapDispenser/ODM/EM/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "batchSyncRoomId": 0, //需要批量同步的房间ID（单设备忽略该字段）
    "batchSyncSpaceId": 0, //需要批量同步的家庭ID（单设备忽略该字段）
    "deviceId": 0, //设备ID
    "goodsId": 0, //关联耗材ID
    "onOffStatus": 0,
    "statisticMode": 0,
    "cleanTipStatus": 0, //清洁提醒状态 0 关闭 1开启
    "cleanTipCount": 0, //清洁提醒间隔次数 如设置50则使用次数累计到50推送清洁提醒
    "remainThreshold": 0, //余量阈值 若为计数检测则固定为0，若为传感器检测 则遵循 0A 1B 2C 3D的分段点位
    "workStatus": 0
  },
  "accessId": "string",  //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每48小时	心跳	无
	每2小时	检测电池电压	首次出现低电
操作触发	每次	上电开机	读取设备的全部状态参数
	每次	开启/关闭待机	设备状态有变更
	每次	开盖/关盖	设备状态有变更
	每次	通过蓝牙APP设置功能参数	功能设置/参数有变更
	每10次	感应出液	统计数据有变更
	每次	换液	设备状态/统计数据有变更
状态触发	每次	出液开始后3s内，自动检测马达运行情况	出现故障
	每次	开盖时，自动检测余量	余量有变化
	每次	出液完成时，自动检测余量	余量有变化

智能大冲 S-FS-WB-FS-001-A

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/FlushingValveBig/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "Stage1_FlushCount": 0, // 第一段累计冲水次数
      "Stage2_FlushCount": 0, // 第二段累计冲水次数
      "DetectSensitivity": 0, // 红外检测灵敏度 默认无人时4s，可调范围4s-6s，步进1s；有人时2s，可调范围2s-3s，步进0.5s
      "AutoDetect": 0, // 自适应感应距离 0 保持 1 开始
      "DetectDistance": 0, // 有效感应距离 默认是约70cm位置处，可调范围0%-100%可调检测距离 PWM参数
      "PulseNumber": 0, // 瞬时水流量（脉冲个数）/秒 代表水压 Q(L/min) = (脉冲数F+3)/5
      "UseStatus": 0, // 设备使用状态 0是无人，1是有人
      "Stage1_FlushTime": 0, // 第一段冲水时长 默认2s，可调范围0-25s，步进1s
      "Stage2_FlushTime": 0, // 第二段冲水时长 默认6s，可调范围3-60s，步进1s
      "WorkStatus": 0, // 工作状态 0停用 1运行
      "UsePulseNumber": 0, // 每人次瞬时水流量（脉冲个数）用水量=F/225
      "TotalPulseNumber": 0, // 累计瞬时水流量（脉冲个数）
      "HwProtocol": 0, // 数据通信方式 0 自动 1 WIFI 2 FSK
      "FlushTest": 0, // 测试冲水 0保持 1执行冲水
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/FlushingValveBig/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "DetectSensitivity": 0, // 红外检测灵敏度 默认无人时4s，可调范围4s-6s，步进1s；有人时2s，可调范围2s-3s，步进0.5s    
    "AutoDetect": 0, // 自适应感应距离 0 保持 1 开始
    "DetectDistance": 0, // 有效感应距离 默认是约70cm位置处，可调范围0%-100%可调检测距离 PWM参数
    "Stage1_FlushTime": 0, // 第一段冲水时长 默认2s，可调范围0-25s，步进1s
    "Stage2_FlushTime": 0, // 第二段冲水时长 默认6s，可调范围3-60s，步进1s
    "WorkStatus": 0, // 工作状态 0停用 1运行
    "HwProtocol": "string", // 数据通信方式 0 自动 1 WIFI 2 FSK
    "FlushTest": 0, // 测试冲水 0保持 1执行冲水
    "CleanTipStatus": 0, // 清洁提醒状态 0关闭 1开启
    "CleanTipCount": 0, // 清洁提醒 阈值次数
    "LinkDeviceId": 0 // 联动设备ID
  },
  "accessId": "string",  //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

智能小冲 S-FS-WB-FS-002-A

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/FlushingValveLite/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "Stage1_FlushCount": 0, // 第一段累计冲水次数
      "Stage2_FlushCount": 0, // 第二段累计冲水次数
      "AutoDetect": 0, // 自适应感应距离 0 保持 1 开始
      "DetectDistance": 0, // 有效感应距离 默认是约60cm位置处，可调范围0%-100%可调检测距离 PWM参数
      "PulseNumber": 0, // 瞬时水流量（脉冲个数）/秒 代表水压 Q(L/min) = (脉冲数F+3)/5
      "UseStatus": 0, // 设备使用状态 0是无人，1是有人
      "Stage1_FlushTime": 0, // 第一段冲水时长 默认2s，可调范围0-25s，步进1s
      "Stage2_FlushTime": 0, // 第二段冲水时长 默认6s，可调范围3-25s，步进1s
      "WorkStatus": 0, // 工作状态 0停用 1运行
      "UsePulseNumber": 0, // 每人次瞬时水流量（脉冲个数）用水量=F/225
      "TotalPulseNumber": 0, // 累计瞬时水流量（脉冲个数）
      "HwProtocol": 0, // 数据通信方式 0 自动 1 WIFI 2 FSK
      "FlushTest": 0, // 测试冲水 0保持 1执行冲水
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/FlushingValveLite/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "AutoDetect": 0, // 自适应感应距离 0 保持 1 开始
    "DetectDistance": 0, // 有效感应距离 默认是约60cm位置处，可调范围0%-100%可调检测距离 PWM参数
    "Stage1_FlushTime": 0, // 第一段冲水时长 默认2s，可调范围0-25s，步进1s
    "Stage2_FlushTime": 0, // 第二段冲水时长 默认6s，可调范围3-25s，步进1s
    "WorkStatus": 0, // 工作状态 0停用 1运行
    "HwProtocol": "string", // 数据通信方式 0 自动 1 WIFI 2 FSK
    "FlushTest": 0, // 测试冲水 0保持 1执行冲水
    "CleanTipStatus": 0, // 清洁提醒状态 0关闭 1开启
    "CleanTipCount": 0, // 清洁提醒 阈值次数
    "LinkDeviceId": 0 // 联动设备ID
  },
  "accessId": "string",  //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

门锁 S-SD-FK-LK-001-0

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/DoorLock/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "lockStatus": 0, // 锁状态 0 开锁 1上锁
      "rssi": 0 // 信号量

    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
操作触发	每次	开锁/关锁	将设备注册给网关或指示灯控制模组后，通过透传数据上报

紧急按钮 SS001

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/EmergencyButton/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "lockStatus": 0, // 按钮状态 1呼叫
      "rssi": 0 // 信号量
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
操作触发	每次	按下红色按钮	将设备注册给网关或指示灯控制模组后，通过透传数据上报

环境传感器 Pro版 S-SD-WB-ES-002-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/Environment/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "NH3": 0, // 氨气 范围0~10PPM，精度0.01PPM
      "H2S": 0, // 硫化氢 范围0~5PPM，精度0.01PPM
      "Tem": 0, // 温度 范围-40~85，精度0.01 整数取值
      "Hum": 0, // 湿度 范围0~100%RH，精度0.01%RH 整数取值
      "PM25": 0, // PM2.5 取值范围：0-250 μg/m3
      "NH3Trigger": 0, // 预警阈值 氨气 默认值为0.6ppm
      "H2STrigger": 0, // 预警阈值 硫化氢 默认值为1ppm
      "TemTrigger": 0, // 预警阈值 温度 默认值为35℃, 整数取值
      "HumTrigger": 0, // 预警阈值 湿度 默认值为75%RH， 整数取值
      "PM25Trigger": 0, // 预警阈值 PM2.5 默认值为75μg/m3
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/Environment/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "beatSpan": 0, // 间隔时间
    "nH3Trigger": 0, // 预警阈值 氨气 默认值为0.6ppm
    "h2STrigger": 0, // 预警阈值 硫化氢 默认值为1ppm
    "temTrigger": 0, // 预警阈值 温度 默认值为35℃, 整数取值
    "humTrigger": 0, // 预警阈值 湿度 默认值为75%RH， 整数取值
    "pM25Trigger": 0, // 预警阈值 PM2.5 默认值为75μg/m3
  },
  "accessId": "string",  //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每24小时	发出心跳	无
	每10分钟	上报采集的环境数据	无
操作触发	每次	给设备上电	无
状态触发	-	传感器保持采集环境数据	检测参数首次达到或低于预警线时

环境传感器 普通版 S-SD-WB-ES-003-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/Environment/003/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "Voc": 0, // 挥发性气体 范围0~1000PPM，精度0.01PPM，整数取值
      "Tem": 0, // 温度 范围-40~85，精度0.01 整数取值
      "Hum": 0, // 湿度 范围0~100%RH，精度0.01%RH 整数取值
      "PM25": 0, // PM2.5 取值范围：0-250 μg/m3
      "VocTrigger": 0, // 预警阈值 挥发性气体 默认值为50ppm
      "TemTrigger": 0, // 预警阈值 温度 默认值为35℃, 整数取值
      "HumTrigger": 0, // 预警阈值 湿度 默认值为75%RH， 整数取值
      "PM25Trigger": 0, // 预警阈值 PM2.5 默认值为75μg/m3
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/Environment/003/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "beatSpan": 0, // 间隔时间
    "vocTrigger": 0, // 预警阈值 挥发性有机物 0~1000PPM
    "temTrigger": 0, // 预警阈值 温度 默认值为35℃, 整数取值
    "humTrigger": 0, // 预警阈值 湿度 默认值为75%RH， 整数取值
    "pM25Trigger": 0, // 预警阈值 PM2.5 默认值为75μg/m3
  },
  "accessId": "string",  //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每24小时	心跳	无
	每10分钟	上报采集的环境数据	无
操作触发	每次	给设备上电	无
状态触发	-	传感器保持采集环境数据	检测参数首次达到或低于预警线时

厕位指示灯 S-DT-AL-TL-003-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/LinkageLight/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "lightMode": 0, // 灯光模式 0默认 1维保模式 - 蓝灯（可下发）【引导灯：2 红灯（满员状态） 3 绿灯（未满状态）】
      "rssi": 0, // 信号量
      "workStatus": 0 // 工作状态 0停用 1运行
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/LinkageLight/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "lightMode": 0, // 灯光模式 0默认 1维保模式 - 蓝灯
    "workStatus": 0 // 工作状态 0停用 1运行
  },
  "accessId": "string",  //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

3. 数据上报机制

触发数据上报的类型	触发频率	功能操作/状态检测的节点	触发条件
定时触发	每24小时	心跳	无
操作触发	每次	给设备上电	无
	每次	通过APP配对设备	功能参数设置有变更
	每次	通过按键配对设备	功能参数设置有变更

厕位引导灯 S-DT-AL-TL-004-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/LinkageLight/004/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "lightMode": 0, // 灯光模式 0默认 1维保模式 - 蓝灯（可下发）【引导灯：2 红灯（满员状态） 3 绿灯（未满状态）】
      "rssi": 0, // 信号量
      "workStatus": 0 // 工作状态 0停用 1运行
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

2. 设备数据下发

请求地址: https://dev.iot.svavo.cn/api/Device/LinkageLight/004/SendSet

请求方式: POST

请求数据:

{
  "sendData": { //发送数据
    "sendProcess": 0, //发送模式 0 委托云端发送 1 生成本地发送字节包 2 本地发送成功应答后更新云端
    "deviceId": 0, //设备ID
    "lightMode": 0, // 灯光模式 0默认 1维保模式 - 蓝灯
    "workStatus": 0 // 工作状态 0停用 1运行
  },
  "accessId": "string",  //访问ID
  "accessSecret": "string" //访问密钥
}

返回数据:

{
  "message": "请求非法",
  "resultCode": 1004, //操作失败
  "success": false, //请求状态
  "data": null //下发不包含数据对象
}

物联网网关 S-DT-AL-DT-003-9

1. 获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/GateWay/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "string", //创建时间
      "dtuNo": "string", //网关编号（独立设备不含网关）
      "getFullData": 0, // 0正常 1获取全量数据
      "rssi": 0, // 信号量
      "workStatus": 0 // 工作状态 0停用 1运行
    },
    "categoryId": 0 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

门锁 S-SD-FK-DD-001-0（洗手间项目）

获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/WashRoom/DoorLock/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true, //请求状态
  "data": { //数据对象
    "latestData": { //最新数据
      "createTime": "2023-10-20 18:09:13", //创建时间
      "dtuNo": "DT00129F00098", //网关编号（独立设备不含网关）
      "deviceNo": "DD00102185864",
      "beatSpan": 0,//心跳间隔
      "powerMode": 1,// 0无外部电源 1有外部电源
      "voltage": 0, //电压 除100
      "messageType": 0, //消息类型
      "rssi": 58, //信号量 参考值
      "lockStatus": 1,// 锁状态 0 关闭 1开启
      "serialNumber": 2185864 //序列号 参考值
    },
    "categoryId": 701 //设备类别ID
  },
  "message": "string", //返回消息
  "resultCode": 1000 //返回码
}

环境传感器 S-SD-LR-ES-001-9（洗手间项目）

获取实时数据

请求地址: https://dev.iot.svavo.cn/api/Device/WashRoom/Environment/LatestData

请求方式: GET

请求参数:

参数名称	数据类型	备注
accessId	string	访问ID
accessSecret	string	访问密钥
deviceNo	string	设备编号

返回数据:

{
  "success": true,
  "data": {
    "latestData": {
      "createTime": "2024-01-11 10:35:23",
      "dtuNo": "DT0012AP00001",
      "deviceNo": "ES0012AA00001",
      "beatSpan": 60, //心跳间隔 秒
      "powerMode": 2, //电源模式 0: 电池供电  1: DC供电  2:AC供电 
      "voltage": 220, //电压 结果值除以100 如：480/100=4.8V
      "messageType": 0,
      "nh3": 0.02, //氨气 ppm
      "h2s": 0.0049, //硫化氢
      "nh3_Trigger": 0.6, //氨气预警值
      "h2s_Trigger": 0.006, //硫化氢预警值
      "tem": 24, //温度 摄氏度
      "tem_Trigger": 35, //温度预警值
      "hum": 26, //湿度 百分比%
      "hum_Trigger": 75, //湿度预警值
      "pm25": 9, //PM2.5 0-250 μg/m3
      "pm25_Trigger": 75 //PM2.5预警值
    },
    "categoryId": 601
  },
  "message": "请求成功",
  "resultCode": 1000
}