API 文档

批量导出设备实例数据 (POST)

更新时间:

该接口支持将设备信息批量导出为 csv、xlsx 格式，不支持导出设备标签和配置信息。

请求接口 ​

POST /api/device/instance/device/batch/export.{format}/{deviceType}

TIP

访问权限：需要登录超级设备管理平台获取token，并校验token。

请求参数 ​

名称位置类型必选说明
X-Access-Tokenheaderstringtrue平台 token
formatpathstringtrue导出文件格式，支持 csv、xlsx
deviceTypepathstringtrue设备类型
bodybodyobjecttrue-
» allFlagbodybooleantrue全选标识， true表示全选
» excludeIdsbodyarrayfalse排除ID列表（排除在全选范围之外的设备ID列表）
» containIdsbodyarrayfalse包含ID列表，全选标识为 false 时必填
» termsbody[object]false过滤条件
»» termsbodystringfalse嵌套条件
»»» termTypebodystringfalse动态条件类型
»»» columnbodystringfalse字段名称
»»» valuebodystringfalse字段值
»»» typebodystringfalse多个条件关联类型，可选值：or、and
  • deviceType：normalDevice（普通设备）/regulator（控制器）/adaptor（适配器）。
  • column：normalDevice对应为superDeviceType，regulator、adaptor对应为categoryType。
  • value：value值为deviceType值。

Body示例 ​

json
{
  "allFlag":false,
  "excludeIds":[],
  "containIds":["111","1686270632456732672","createDevice"],
  "terms":[
    {
      "terms":[
        {
          "termType":"eq",
          "column":"superDeviceType",
          "value":"normalDevice",
          "type":"and"
        }
      ]
    }
  ]
}
{
  "allFlag":false,
  "excludeIds":[],
  "containIds":["111","1686270632456732672","createDevice"],
  "terms":[
    {
      "terms":[
        {
          "termType":"eq",
          "column":"superDeviceType",
          "value":"normalDevice",
          "type":"and"
        }
      ]
    }
  ]
}