| 接口用途 | 获取设备实时参数等信息 |
|---|---|
| 请求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
最后编辑:vita 更新时间:2025-10-20 09:58