接口用途 获取设备实时参数等信息
请求URL /tytapi/device_details
请求方式 POST

参数:

参数名 必选 类型 说明
token string token
id string 设备id
machine_sn string 设备编码,v1.0.5新增,与设备id作用相同,后续以machine_sn为主

设备在线返回示例

{
  "error_code": 0,
  "error_msg": "获取数据成功",
  "data": {
    "machine_info": {
      "id": "278",
      "customer_id": "6",
      "site_id": "11",
      "room_id": "18",
      "bin_id": "37",
      "zone_id": null,
      "device_usage": "0",
      "is_total": "0",
      "is_count_device": "0",
      "machine_sn": "83780755002701",
      "concentrator_sn": "83780755002003",
      "machine_name": "主进线变压器",
      "machine_code": "701",
      "machine_id": null,
      "type": "4",
      "type_id": "35",
      "dev_model": "",
      "model_name": "S13",
      "img_url": "http://future.taiyong.net/img/product/transformer/youjin.png",
      "base_info": "1",
      "controller_info": "",
      "transformer_param": "",
      "temp_param": null,
      "output_type": null,
      "modbus_address": null,
      "produce_date": "2021-08-17",
      "create_time": "2021-08-17 10:00:00",
      "last_update_time": "2023-06-14 10:57:41",
      "status": "1",
      "dev_band": null,
      "active_status": "1",
      "mobile_card": null,
      "switch_on_addr": null,
      "switch_off_addr": null,
      "is_deleted": "0",
      "software_version": null,
      "alarm_config": null,
      "task_param": null,
      "device_param": null,
      "sort_value": "100"
    },
    "realtime_info": {
      "id": "317",
      "machine_sn": "83780755002701",
      "machine_type": "S13",
      "realtime_data":"{\"l1pv\":\"222.32V\",\"l2pv\":\"221.92V\",\"l3pv\":\"226.87V\",\"l12pv\":\"378.59V\",\"l23pv\":\"381.98V\",\"l31pv\":\"372.75V\",\"l1pc\":\"125.15A\",\"l2pc\":\"126.84A\",\"l3pc\":\"125.13A\",\"freq\":\"50.06Hz\",\"l1ipoa\":\"27.82kVA\",\"l2ipoa\":\"28.39kVA\",\"tioa\":\"84.36kVA\",\"l1pap\":\"23.93kW\",\"l2pap\":\"24.21kW\",\"l3pap\":\"23.28kW\",\"tap\":\"71.42kW\",\"l1prp\":\"14.2kvar\",\"l2prp\":\"14.36kvar\",\"l3prp\":\"16.25kvar\",\"trp\":\"44.81kvar\",\"l1ppf\":\"0.86\",\"l2ppf\":\"0.86\",\"l3ppf\":\"0.82\",\"temp1\":\"59.0\℃\",\"l1pc2hd\":\"6.64%\",\"l2pc2hd\":\"5.46%\",\"l3pc2hd\":\"3.18%\",\"l1pc3hd\":\"11.28%\",\"l2pc3hd\":\"14.94%\",\"l3pc3hd\":\"14.0%\",\"l1pc4hd\":\"6.22%\",\"l2pc4hd\":\"5.91%\",\"l3pc4hd\":\"4.28%\",\"l1pc5hd\":\"16.32%\",\"l2pc5hd\":\"12.29%\",\"l3pc5hd\":\"11.68%\",\"l1pc6hd\":\"4.88%\",\"l2pc6hd\":\"3.21%\",\"l3pc6hd\":\"5.49%\",\"l1pc7hd\":\"12.65%\",\"l2pc7hd\":\"15.46%\",\"l3pc7hd\":\"10.43%\",\"l1pc8hd\":\"2.61%\",\"l2pc8hd\":\"4.98%\",\"l3pc8hd\":\"5.22%\",\"l1pc9hd\":\"13.17%\",\"l2pc9hd\":\"10.23%\",\"l3pc9hd\":\"14.09%\",\"l1pc10hd\":\"1.95%\",\"l2pc10hd\":\"4.34%\",\"l3pc10hd\":\"2.35%\",\"l1pc11hd\":\"12.87%\",\"l2pc11hd\":\"12.38%\",\"l3pc11hd\":\"9.97%\",\"l1pc12hd\":\"1.26%\",\"l2pc12hd\":\"2.01%\",\"l3pc12hd\":\"0.98%\",\"l1pc13hd\":\"13.95%\",\"l2pc13hd\":\"13.32%\",\"l3pc13hd\":\"14.93%\",\"l1pc14hd\":\"5.25%\",\"l2pc14hd\":\"5.58%\",\"l3pc14hd\":\"3.4%\",\"l1pc15hd\":\"11.26%\",\"l2pc15hd\":\"11.65%\",\"l3pc15hd\":\"10.15%\",\"l1pc16hd\":\"0.74%\",\"l2pc16hd\":\"0.73%\",\"l3pc16hd\":\"1.55%\",\"l1pc17hd\":\"9.35%\",\"l2pc17hd\":\"10.22%\",\"l3pc17hd\":\"14.44%\",\"l1pc18hd\":\"4.42%\",\"l2pc18hd\":\"0.78%\",\"l3pc18hd\":\"2.28%\",\"l1pc19hd\":\"10.57%\",\"l2pc19hd\":\"11.52%\",\"l3pc19hd\":\"11.98%\",\"l1pc20hd\":\"1.32%\",\"l2pc20hd\":\"0.63%\",\"l3pc20hd\":\"0.31%\",\"l1pc21hd\":\"10.06%\",\"l2pc21hd\":\"14.57%\",\"l3pc21hd\":\"14.22%\",\"l1pc22hd\":\"1.89%\",\"l2pc22hd\":\"0.15%\",\"l3pc22hd\":\"4.78%\",\"l1pc23hd\":\"11.34%\",\"l2pc23hd\":\"9.58%\",\"l3pc23hd\":\"12.26%\",\"l1pc24hd\":\"1.38%\",\"l2pc24hd\":\"4.16%\",\"l3pc24hd\":\"1.13%\",\"l1pc25hd\":\"11.42%\",\"l2pc25hd\":\"12.75%\",\"l3pc25hd\":\"12.24%\",\"l1pc26hd\":\"4.16%\",\"l2pc26hd\":\"3.31%\",\"l3pc26hd\":\"1.76%\",\"l1pc27hd\":\"9.32%\",\"l2pc27hd\":\"8.63%\",\"l3pc27hd\":\"10.65%\",\"l1pc28hd\":\"-0.54%\",\"l2pc28hd\":\"1.74%\",\"l3pc28hd\":\"-0.44%\",\"l1pc29hd\":\"13.33%\",\"l2pc29hd\":\"9.58%\",\"l3pc29hd\":\"10.85%\",\"l1pc30hd\":\"3.66%\",\"l2pc30hd\":\"0.42%\",\"l3pc30hd\":\"1.35%\",\"l1pc31hd\":\"8.77%\",\"l2pc31hd\":\"9.19%\",\"l3pc31hd\":\"10.95%\",\"l1pcthd\":\"48.16%\",\"l2pcthd\":\"48.23%\",\"l3pcthd\":\"49.1%\",\"l1pctohd\":\"45.99%\",\"l2pctohd\":\"46.25%\",\"l3pctohd\":\"47.65%\",\"l1pctehd\":\"14.31%\",\"l2pctehd\":\"13.67%\",\"l3pctehd\":\"11.87%\",\"l1pv2hd\":\"0.42%\",\"l2pv2hd\":\"0.61%\",\"l3pv2hd\":\"0.35%\",\"l1pv3hd\":\"1.18%\",\"l2pv3hd\":\"1.11%\",\"l3pv3hd\":\"1.6%\",\"l1pv4hd\":\"0.25%\",\"l2pv4hd\":\"0.61%\",\"l3pv4hd\":\"0.53%\",\"l1pv5hd\":\"1.3%\",\"l2pv5hd\":\"1.24%\",\"l3pv5hd\":\"1.09%\",\"l1pv6hd\":\"0.44%\",\"l2pv6hd\":\"0.18%\",\"l3pv6hd\":\"0.38%\",\"l1pv7hd\":\"1.46%\",\"l2pv7hd\":\"1.19%\",\"l3pv7hd\":\"1.04%\",\"l1pv8hd\":\"0.33%\",\"l2pv8hd\":\"0.55%\",\"l3pv8hd\":\"0.43%\",\"l1pv9hd\":\"1.05%\",\"l2pv9hd\":\"1.54%\",\"l3pv9hd\":\"1.46%\",\"l1pv10hd\":\"0.16%\",\"l2pv10hd\":\"0.56%\",\"l3pv10hd\":\"0.56%\",\"l1pv11hd\":\"1.17%\",\"l2pv11hd\":\"1.11%\",\"l3pv11hd\":\"1.43%\",\"l1pv12hd\":\"0.3%\",\"l2pv12hd\":\"0.21%\",\"l3pv12hd\":\"0.16%\",\"l1pv13hd\":\"1.31%\",\"l2pv13hd\":\"1.37%\",\"l3pv13hd\":\"1.37%\",\"l1pv14hd\":\"0.52%\",\"l2pv14hd\":\"0.13%\",\"l3pv14hd\":\"0.1%\",\"l1pv15hd\":\"1.45%\",\"l2pv15hd\":\"1.48%\",\"l3pv15hd\":\"1.3%\",\"l1pv16hd\":\"0.26%\",\"l2pv16hd\":\"0.36%\",\"l3pv16hd\":\"0.24%\",\"l1pv17hd\":\"1.12%\",\"l2pv17hd\":\"1.52%\",\"l3pv17hd\":\"1.22%\",\"l1pv18hd\":\"0.47%\",\"l2pv18hd\":\"0.47%\",\"l3pv18hd\":\"0.26%\",\"l1pv19hd\":\"1.51%\",\"l2pv19hd\":\"1.04%\",\"l3pv19hd\":\"1.32%\",\"l1pv20hd\":\"0.16%\",\"l2pv20hd\":\"0.22%\",\"l3pv20hd\":\"0.34%\",\"l1pv21hd\":\"1.12%\",\"l2pv21hd\":\"1.15%\",\"l3pv21hd\":\"1.03%\",\"l1pv22hd\":\"0.48%\",\"l2pv22hd\":\"0.4%\",\"l3pv22hd\":\"0.01%\",\"l1pv23hd\":\"1.09%\",\"l2pv23hd\":\"1.09%\",\"l3pv23hd\":\"1.21%\",\"l1pv24hd\":\"0.13%\",\"l2pv24hd\":\"0.1%\",\"l3pv24hd\":\"0.23%\",\"l1pv25hd\":\"0.99%\",\"l2pv25hd\":\"1.33%\",\"l3pv25hd\":\"0.99%\",\"l1pv26hd\":\"0.2%\",\"l2pv26hd\":\"0.01%\",\"l3pv26hd\":\"-0.05%\",\"l1pv27hd\":\"1.34%\",\"l2pv27hd\":\"0.84%\",\"l3pv27hd\":\"1.12%\",\"l1pv28hd\":\"0.01%\",\"l2pv28hd\":\"0.26%\",\"l3pv28hd\":\"0.02%\",\"l1pv29hd\":\"1.18%\",\"l2pv29hd\":\"0.9%\",\"l3pv29hd\":\"0.91%\",\"l1pv30hd\":\"0.01%\",\"l2pv30hd\":\"0.37%\",\"l3pv30hd\":\"-0.05%\",\"l1pv31hd\":\"0.91%\",\"l2pv31hd\":\"1.09%\",\"l3pv31hd\":\"1.29%\",\"l1pvthd\":\"4.9%\",\"l2pvthd\":\"4.95%\",\"l3pvthd\":\"4.94%\",\"l1pvtohd\":\"4.74%\",\"l2pvtohd\":\"4.72%\",\"l3pvtohd\":\"4.8%\",\"l1pvtehd\":\"1.24%\",\"l2pvtehd\":\"1.49%\",\"l3pvtehd\":\"1.18%\"}",
      "status_data": null,
      "total_data": null,
      "update_time": "2023-07-03 18:42:22"
    },
    "power": [
      {
        "report_time": "00:00:02",
        "name": "主进线变压器",
        "report_data": {
          "pa": "20.29kW",
          "pb": "21.54kW",
          "pc": "21.23kW",
          "pt": "63.06kW"
        }
      },
      {
        "report_time": "00:05:01",
        "name": "主进线变压器",
        "report_data": {
          "pa": "23.76kW",
          "pb": "27.17kW",
          "pc": "26.25kW",
          "pt": "77.18kW"
        }
      },
      {
        "report_time": "23:55:01",
        "name": "主进线变压器",
        "report_data": {
          "pa": "23.76kW",
          "pb": "27.17kW",
          "pc": "26.25kW",
          "pt": "77.18kW"
        }
      }
    ],
    "alarm_data": [],
    "alarm_count": {
      "total": "0",
      "unread": "0",
      "read": 0,
      "last_30_days": "0"
    }
  }
}

返回参数说明

参数名 类型 说明
error_code int 错误代码
error_msg string 信息
data json 返回数据
machine_info json 设备信息
realtime_info json 实时数据
power json 设备实时功率(24小时每5分钟一个数据)
alarm_data json 报警数据
alarm_count json 报警数据数量

设备信息 machine_info 数据结构

参数名 类型 说明
id string 数据库里设备唯一id
customer_id string 客户id
site_id string 项目地id
room_id string 配电室id
bin_id string 配电柜id
zone_id string 区域id
device_usage string 设备用途
is_total string 是否为总线设备 0 否 1 是
is_count_device string 是否为可统计的最末端设备 0否 1是
machine_sn string 设备编号
concentrator_sn string 集中器编号
machine_name string 设备名称
machine_code string 台账编号
machine_id string 子设备ID
type string 设备类型ID 即大类(对应machine_type里的type字段
type_id string 设备型号ID 即小类(对应machine_type里的type_id字段)
dev_model string 设备型号(废弃,用model_name)
model_name string 控制器型号(设备型号)
img_url string 设备图片
base_info string 安装方式
controller_info string 测量方式
transformer_param string 温度测控设备名称
temp_param string 温度测控设备名称
output_type string 输出方式
modbus_address string Modbus地址
produce_date string 生产日期
create_time string 添加时间
last_update_time string 最后修改时间
status string 设备状态:0/离线 1/在线
dev_band string 品牌
active_status string 使用状态: 0/停用 1/启用
mobile_card string 物联网卡号
switch_on_addr string 合闸线圈地址
switch_off_addr string 分闸线圈地址
is_deleted string 是否删除网关配置信息(用于智能微断)
software_version string 软件版本(MB3)
alarm_config string
task_param string 定时任务(MB3)
device_param string 网关/子设备参数(MB3)
sort_value string 排序 值越大越靠前

实时数据 realtime_info

参数名 类型 说明
id int 设备id
machine_sn string 设备编码
machine_type string 设备类型
realtime_data json 实时数据 不同设备数据结构不同
请参照《低压配电设备数据点表》
status_data json 状态信息 mb3设备为null
total_data json 汇总信息 mb3设备为nu
update_time string 更新时间

设备实时功率 power

参数名 类型 说明
report_time string 统计时间
name string 设备名称
report_data json 统计数据 每5分钟统计一次 设备离线则不统计
pa string A相有功功率
pb string B相有功功率
pc string C相有功功率
pt string 总有功功率

报警数据 alarm_count

参数名 类型 说明
total styring 总报警数量
unread strin 未读数量
read string 已读数量
last_30_days string 最近30天数量
作者:vita  创建时间:2025-10-20 09:58
最后编辑:vita  更新时间:2025-10-20 09:58