Skip to content

查询明厨亮灶设备所属监控区域 ​

接口功能 ​

按设备查询明厨亮灶设备所属监控区域,支持多设备查询。

请求地址 ​

https://open.qly.cmviot.cn/v3/open/api/mclz/company/device/monitorArea/query

请求方式 ​

POST,需要鉴权

请求参数 ​

参数名称参数类型是否必需参数含义说明
companyIdStringN企业 id
deviceIdsList<String>Y设备 id 列表非空,最多 200 个;每项为非空字符串,支持原始 MAC 或「前缀_mac」格式

请求示例 ​

json
{
  "companyId": "11111",
  "deviceIds": ["xxxxS_AABBCCDDEEFF", "112233445566"]
}

响应参数 ​

参数名称参数类型参数含义说明
resultCodeString响应码
resultMsgString结果说明
dataArray设备监控区域列表DeviceMonitorArea 数组,与入参 deviceIds 一一对应(数量、顺序一致),失败响应可以不含 data

DeviceMonitorArea 对象模型 ​

名称类型参数含义说明
deviceIdString设备 id原样返回入参中的值
mainBusinessNameString主营行业名称一级企业类型名称;无则 null
mainBusinessCodeString主营行业编码一级企业类型 code;无则 null
monitorAreaNameString监控区域名称无则 null
monitorAreaCodeString监控区域编码无则 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服务器内部错误