| 接口用途 | 获取设备列表 |
|---|---|
| 请求URL | /tytapi/machine_list |
| 请求方式 | POST |
参数:
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| token | 是 | string | token |
| site_id | 是 | string | 项目地编号 |
| cur_page | 否 | string | 当前页码 默认1 |
| count | 否 | string | 每页设备数量 默认20 |
| room_id | 否 | string | 配电室编号 |
| type | 否 | string | 设备类型 |
| model_name | 否 | string | 设备型号 支持模糊搜索 |
| status | 否 | string | 在线状态 |
| machine_sn | 否 | string | 设备编号 支持模糊搜索 |
| machine_name | 否 | string | 设备名称 支持模糊搜索 |
| gateway_sn | 否 | string | 网关编号 支持模糊搜索 |
返回示例
{
"error_code": 0,
"error_msg": "获取数据成功",
"data": {
"count": 3,
"total_count": 9,
"page_size": 3,
"cur_page": 2,
"list": [
{
"id": "2187",
"customer_id": "3",
"site_id": "25",
"room_id": "42",
"bin_id": "99",
"zone_id": "0",
"device_usage": "0",
"is_total": "0",
"is_count_device": "0",
"machine_sn": "2204250500005361",
"concentrator_sn": "2208029990018487",
"machine_name": "load",
"machine_code": "003",
"machine_id": "50",
"type": "14",
"type_id": "50",
"dev_model": null,
"model_name": "MB3L-63-2P",
"img_url": null,
"base_info": null,
"controller_info": null,
"transformer_param": null,
"temp_param": null,
"output_type": null,
"modbus_address": null,
"produce_date": "2023-07-03",
"create_time": "2023-07-03 14:20:58",
"last_update_time": "2023-07-03 17:16:48",
"status": "0",
"dev_band": null,
"active_status": "1",
"mobile_card": null,
"switch_on_addr": "1800",
"switch_off_addr": "1801",
"is_deleted": "0",
"software_version": null,
"alarm_config": "{\"baudrate\":3,\"host\":3,\"oc_alarm\":\"0.00\",\"oc_alarm_status\":\"0.00\",\"oc_start\":\"63.00\",\"oc_start_time\":\"3.00\",\"of_alarm\":\"0.00\",\"of_alarm_status\":\"0.00\",\"of_return\":\"50.40\",\"of_return_time\":\"30.00\",\"of_start\":\"50.50\",\"of_start_time\":\"3.00\",\"ov_alarm\":\"0.00\",\"ov_alarm_status\":\"0.00\",\"ov_return\":\"242.00\",\"ov_return_time\":\"30.00\",\"ov_start\":\"253.00\",\"ov_start_time\":\"3.00\",\"ps_alarm\":\"0.00\",\"ps_default\":\"2.00\",\"stopbit\":2,\"uf_alarm\":\"0.00\",\"uf_alarm_status\":\"0.00\",\"uf_return\":\"49.60\",\"uf_return_time\":\"30.00\",\"uf_start\":\"49.50\",\"uf_start_time\":\"3.00\",\"uv_alarm\":\"0.00\",\"uv_alarm_status\":\"0.00\",\"uv_return\":\"198.00\",\"uv_return_time\":\"30.00\",\"uv_start\":\"187.00\",\"uv_start_time\":\"3.00\"}",
"task_param": "{\"task\":[{\"index\":0,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0},{\"index\":1,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0},{\"index\":2,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0},{\"index\":3,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0},{\"index\":4,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0},{\"index\":5,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0},{\"index\":6,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0},{\"index\":7,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0},{\"index\":8,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0},{\"index\":9,\"opera_type\":0,\"period\":0,\"status\":0,\"time_day\":1,\"time_hour\":0,\"time_minute\":0,\"time_month\":1,\"time_second\":0,\"time_week\":6,\"time_year\":0}]}",
"device_param": null,
"sort_value": "0"
},
{
"id": "2189",
"customer_id": "3",
"site_id": "25",
"room_id": "42",
"bin_id": "99",
"zone_id": "0",
"device_usage": "0",
"is_total": "0",
"is_count_device": "0",
"machine_sn": "2208040500021144",
"concentrator_sn": "2208029990018487",
"machine_name": "无字样",
"machine_code": "003",
"machine_id": "50",
"type": "14",
"type_id": "50",
"dev_model": null,
"model_name": "MB3-63-2P",
"img_url": null,
"base_info": null,
"controller_info": null,
"transformer_param": null,
"temp_param": null,
"output_type": null,
"modbus_address": null,
"produce_date": "2023-07-03",
"create_time": "2023-07-03 14:28:06",
"last_update_time": "2023-07-03 14:42:35",
"status": "0",
"dev_band": null,
"active_status": "1",
"mobile_card": null,
"switch_on_addr": "1800",
"switch_off_addr": "1801",
"is_deleted": "0",
"software_version": null,
"alarm_config": "",
"task_param": "",
"device_param": null,
"sort_value": "0"
},
{
"id": "1995",
"customer_id": "3",
"site_id": "25",
"room_id": "42",
"bin_id": "99",
"zone_id": "0",
"device_usage": "0",
"is_total": "0",
"is_count_device": "0",
"machine_sn": "2305120500002620",
"concentrator_sn": "2302289990067645",
"machine_name": "总开关C63",
"machine_code": "800001",
"machine_id": "50",
"type": "14",
"type_id": "50",
"dev_model": null,
"model_name": "MB3L-63-2P",
"img_url": null,
"base_info": null,
"controller_info": null,
"transformer_param": null,
"temp_param": null,
"output_type": null,
"modbus_address": null,
"produce_date": "2023-05-15",
"create_time": "2023-05-15 14:49:18",
"last_update_time": null,
"status": "1",
"dev_band": null,
"active_status": "1",
"mobile_card": null,
"switch_on_addr": "1800",
"switch_off_addr": "1801",
"is_deleted": "0",
"software_version": null,
"alarm_config": "",
"task_param": "",
"device_param": null,
"sort_value": "0"
}
]
}
}返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| error_code | int | 错误代码 |
| error_msg | string | 信息 |
| data | string | 返回数据 |
data数据结构
| 参数名 | 类型 | 说明 |
|---|---|---|
| count | string | 每页设备数量 |
| total_count | string | 总设备数量 |
| page_size | string | 总页数 |
| cur_page | string | 当前页码 |
| list | json | machine_info 设备列表 |
** 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 | 排序 值越大越靠前 |
作者:vita 创建时间:2025-10-20 09:55
最后编辑:vita 更新时间:2025-10-20 09:55
最后编辑:vita 更新时间:2025-10-20 09:55