查询明厨亮灶设备所属监控区域
接口功能
按设备查询明厨亮灶设备所属监控区域,支持多设备查询。
请求地址
https://open.qly.cmviot.cn/v3/open/api/mclz/company/device/monitorArea/query请求方式
POST,需要鉴权
请求参数
| 参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
|---|---|---|---|---|
| companyId | String | N | 企业 id | |
| deviceIds | List<String> | Y | 设备 id 列表 | 非空,最多 200 个;每项为非空字符串,支持原始 MAC 或「前缀_mac」格式 |
请求示例
json
{
"companyId": "11111",
"deviceIds": ["xxxxS_AABBCCDDEEFF", "112233445566"]
}响应参数
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| resultCode | String | 响应码 | |
| resultMsg | String | 结果说明 | |
| data | Array | 设备监控区域列表 | DeviceMonitorArea 数组,与入参 deviceIds 一一对应(数量、顺序一致),失败响应可以不含 data |
DeviceMonitorArea 对象模型
| 名称 | 类型 | 参数含义 | 说明 |
|---|---|---|---|
| deviceId | String | 设备 id | 原样返回入参中的值 |
| mainBusinessName | String | 主营行业名称 | 一级企业类型名称;无则 null |
| mainBusinessCode | String | 主营行业编码 | 一级企业类型 code;无则 null |
| monitorAreaName | String | 监控区域名称 | 无则 null |
| monitorAreaCode | String | 监控区域编码 | 无则 null |
响应示例
成功响应:
json
{
"resultCode": "000000",
"resultMsg": "成功",
"data": [
{
"deviceId": "xxxxS_AABBCCDDEEFF",
"mainBusinessName": "食品生产",
"mainBusinessCode": "2000",
"monitorAreaName": "原辅料验收、贮存",
"monitorAreaCode": "21"
},
{
"deviceId": "112233445566",
"mainBusinessName": null,
"mainBusinessCode": null,
"monitorAreaName": null,
"monitorAreaCode": null
}
]
}失败响应:
json
{
"resultCode": "-101",
"resultMsg": "必填参数缺失"
}响应码说明
| 码值 | 消息 | 说明 |
|---|---|---|
| 000000 | 成功 | |
| -101 | 必填参数缺失(deviceIds 不能为空) | |
| -102 | 参数格式错误(deviceIds 最多支持 200 个设备) | |
| -100 | 服务器内部错误 |