# 设备列表接口

> API ID: 1681109889047052

---

## 基本信息

| 项目 | 值 |
|------|-----|
| 接口名称 | 设备列表接口 |
| 接口编号 | BLACKLAKE-1681109889047052 |
| 请求方式 | `POST` |
| 接口路径 | `/resource/open/v1/resources/list` |

## 请求参数

### 请求头

- **access_token** `string` **必填** - token

### 请求体

- **beginEnableDate** `integer` `2021/07/08` - 启用日期-开始
- **beginEnableDateTime** `string` `2021/07/08` - 启用日期-开始
- **beginEnterFactoryDate** `integer` `2021/07/08` - 入厂日期-开始
- **beginEnterFactoryDateTime** `string` `2021/07/08` - 入厂日期-开始
- **beginOutFactoryDate** `integer` `2021/07/06` - 出厂日期-开始
- **beginOutFactoryDateTime** `string` `2021/07/06` - 出厂日期-开始
- **beginPlanScrapDate** `integer` `2121213318` - 报废日期-开始- 时间戳
- **beginPlanScrapDateTime** `string` `2021/07/08` - 报废日期-开始
- **bladeOutPutLimitRange** `object` - 刀具产出上限查询范围[min,max]
  > 对象字段：
  - **max** `integer`
  - **min** `integer`
- **bladeUsageCountLimitRange** `object` - 刀具使用上限查询范围[min,max]
  > 对象字段：
  - **max** `integer`
  - **min** `integer`
- **brandModel** `integer` `10` - 品牌模式
- **businessIdList** `integer []` `[1001,1002]` - 业务范围
- **businessType** `integer` `10` - 业务类型
- **cavityNoRange** `object`
  > 对象字段：
  - **max** `integer`
  - **min** `integer`
- **classificationId** `integer` `1001` - 资源分类Id
- **code** `string` `a00001` - 资源编号
- **defaultOrderBy** `string`
- **departmentIdList** `integer []` `[1001,1002]` - 负责部门Id集合
- **endEnableDate** `integer` `2021/07/08` - 启用日期-结束
- **endEnableDateTime** `string` `2021/07/08` - 启用日期-结束
- **endEnterFactoryDate** `integer` `2021/07/08` - 入厂日期-结束
- **endEnterFactoryDateTime** `string` `2021/07/08` - 入厂日期-结束
- **endOutFactoryDate** `integer` `2021/07/08` - 出厂日期-结束
- **endOutFactoryDateTime** `string` `2021/07/08` - 出厂日期-结束
- **endPlanScrapDate** `integer` `2121213318` - 报废日期-结束 - 时间戳
- **endPlanScrapDateTime** `string` `2021/07/08` - 报废日期-结束
- **entityLinkCode** `string` `0001200001` - 标识码
- **exportSubFlag** `boolean` - 导出所有子设备,（导出专用）
- **externalNo** `string` `1001` - 外部ID类似于mac地址
- **idList** `integer []` `[1001,1002]` - id集合
- **lifespanStatus** `integer` - 寿命状态
- **locationId** `integer` `1` - 区域ID
- **locationIdList** `integer []` `false` - 区域集合
- **lockStatus** `integer`
- **manufacturer** `string` `1001` - 制造商
- **model** `string`
- **name** `string` `拖拉机` - 资源名称
- **onWayStatus** `integer`
- **openLimitRange** `object`
  > 对象字段：
  - **max** `integer`
  - **min** `integer`
- **orgId** `integer` `10` - 工厂ID
- **outPutLimitRange** `object`
  > 对象字段：
  - **max** `integer`
  - **min** `integer`
- **page** `integer` `1` - 请求页
- **parentFlag** `boolean` `true` - 是否只展示第一级，true 为 是，false 为否
- **parentId** `integer` `121212` - 父级ID
- **quickSearch** `string` `拖拉机` - 快捷查询
- **remark** `string` `1001` - 备注
- **responsibleLinkIdList** `integer []`
- **selectFlag** `integer` - 筛选标识 1 全选 0 不全选 默认为 0
- **selectNoLocationFlag** `boolean` - 查看无区域资源, true - 是，false - 否
- **serialNo** `string` `1001` - 序列号
- **size** `integer` `20` - 每页大小
- **sorter** `object []` - 排序 列表顺序表示排序顺序
  > 数组元素字段：
  - **field** `string` `name` - 排序字段
  - **order** `string` `asc` - 排序规律 默认 asc，asc 升序 desc 降序
- **sourceType** `integer`
- **status** `integer` `1` - 状态
- **statusList** `integer []` `1` - 状态集合
- **subLocationFlag** `boolean` - 是否展示子区域
- **supplierIdList** `integer []` `1001` - 供应商ID
- **tagsIdList** `integer []` `[1,2,3]` - 标签ID集合
- **tagsLinkIdList** `integer []`
- **type** `integer` - 资源类型 枚举 0- 设备 ，1 -能源仪表
- **unitId** `integer` `1` - 单位Id
- **updatedEndDateTime** `string` `2021/07/06` - 更新时间-开始
- **updatedEndTime** `integer` `1689163048000` - 更新时间-结束
- **updatedStartDateTime** `string` `2021/07/06` - 更新时间-开始
- **updatedStartTime** `integer` `1689163048000` - 更新时间-开始
- **useAge** `integer` `1001` - 使用年限
- **useAgeType** `integer` `1001` - 使用年限单位- 数值
- **userIdList** `integer []` `[1001,1002]` - 负责用户Id集合

## 请求示例

```json
{
  "beginEnableDate": null,
  "beginEnableDateTime": "2021/07/08",
  "beginEnterFactoryDate": null,
  "beginEnterFactoryDateTime": "2021/07/08",
  "beginOutFactoryDate": null,
  "beginOutFactoryDateTime": "2021/07/06",
  "beginPlanScrapDate": 2121213318,
  "beginPlanScrapDateTime": "2021/07/08",
  "bladeOutPutLimitRange": {
    "max": 0,
    "min": 0
  },
  "bladeUsageCountLimitRange": {
    "max": 0,
    "min": 0
  },
  "brandModel": 10,
  "businessIdList": [
    1001,
    1002
  ],
  "businessType": 10,
  "cavityNoRange": {
    "max": 0,
    "min": 0
  },
  "classificationId": 1001,
  "code": "a00001",
  "defaultOrderBy": "string",
  "departmentIdList": [
    1001,
    1002
  ],
  "endEnableDate": null,
  "endEnableDateTime": "2021/07/08",
  "endEnterFactoryDate": null,
  "endEnterFactoryDateTime": "2021/07/08",
  "endOutFactoryDate": null,
  "endOutFactoryDateTime": "2021/07/08",
  "endPlanScrapDate": 2121213318,
  "endPlanScrapDateTime": "2021/07/08",
  "entityLinkCode": "0001200001",
  "exportSubFlag": false,
  "externalNo": "1001",
  "idList": [
    1001,
    1002
  ],
  "lifespanStatus": 0,
  "locationId": 1,
  "locationIdList": [
    null
  ],
  "lockStatus": 0,
  "manufacturer": "1001",
  "model": "string",
  "name": "拖拉机",
  "onWayStatus": 0,
  "openLimitRange": {
    "max": 0,
    "min": 0
  },
  "orgId": 10,
  "outPutLimitRange": {
    "max": 0,
    "min": 0
  },
  "page": 1,
  "parentFlag": true,
  "parentId": 121212,
  "quickSearch": "拖拉机",
  "remark": "1001",
  "responsibleLinkIdList": [
    0
  ],
  "selectFlag": 0,
  "selectNoLocationFlag": false,
  "serialNo": "1001",
  "size": 20,
  "sorter": [
    {
      "field": "name",
      "order": "asc"
    }
  ],
  "sourceType": 0,
  "status": 1,
  "statusList": [
    1
  ],
  "subLocationFlag": false,
  "supplierIdList": [
    1001
  ],
  "tagsIdList": [
    1,
    2,
    3
  ],
  "tagsLinkIdList": [
    0
  ],
  "type": 0,
  "unitId": 1,
  "updatedEndDateTime": "2021/07/06",
  "updatedEndTime": 1689163048000,
  "updatedStartDateTime": "2021/07/06",
  "updatedStartTime": 1689163048000,
  "useAge": 1001,
  "useAgeType": 1001,
  "userIdList": [
    1001,
    1002
  ]
}
```

## 返回数据

### 返回数据

- **code** `integer` **必填** `200` - 状态码
- **data** `object` - 数据
  > 对象字段：
  - **brandModel** `string` - 品牌型号
  - **businessType** `string` - 业务类型
  - **childrenCodeStr** `string` - 子级设备编号
  - **classificationCode** `string` - 设备分类编号
  - **code** `string` - 设备编号
  - **codeEntityLinkCode** `string` - 标识码
  - **createdAt** `string` - 创建时间
  - **createdTime** `integer` - 创建时间Long
  - **customFields** `object []`
    > 数组元素字段：
    - **choiceValues** `object []`
      > 数组元素字段：
      - **choiceCode** `string`
      - **choiceValue** `string`
      - **id** `integer`
      - **isDefault** `integer`
      - **sequence** `integer`
    - **datetimeFormat** `string`
    - **decimalNumber** `integer`
    - **defaultValue** `string`
    - **editable** `integer`
    - **esField** `string`
    - **fieldCode** `string`
    - **fieldEsValue** `object`
    - **fieldExportValue** `object`
    - **fieldId** `integer`
    - **fieldName** `string`
    - **fieldRemind** `string`
    - **fieldType** `integer`
    - **fieldValue** `object`
    - **isRefer** `integer`
    - **isRequired** `integer`
    - **isUsed** `integer`
    - **maxLength** `integer`
    - **maxValue** `integer`
    - **objectCode** `string`
    - **reference** `string`
    - **targetType** `integer`
    - **visible** `integer`
  - **departmentCodesStr** `string` - 负责部门编号
  - **enableDateStr** `string` - 启用日期
  - **enterFactoryDateStr** `string` - 入厂日期
  - **externalNo** `string` - 外部ID
  - **id** `integer` - 设备id
  - **inputStorageCodes** `string` - 投料仓位
  - **locationCode** `string` - 存储区域编号
  - **name** `string` - 设备名称
  - **outFactoryDateStr** `string` - 出厂日期
  - **outputStorageCodes** `string` - 产出仓位
  - **paramsDOList** `object []` - 设备参数
    > 数组元素字段：
    - **code** `string` - 设备编号
    - **paramsCode** `string` - 设备参数编号
    - **paramsDownApi** `string` - 参数下发API
    - **paramsFloorLimit** `number` - 参数下下限
    - **paramsLowerLimit** `number` - 参数下限
    - **paramsReadApi** `string` - 参数读取API
    - **paramsStandard** `number` - 参数标准值
    - **paramsTopLimit** `number` - 参数上上限
    - **paramsUpperLimit** `number` - 参数上限
  - **parentCode** `string` - 父级设备编号
  - **planScrapDate** `string` - 计划报废日期
  - **remark** `string` - 备注
  - **serialNo** `string` - 序列号
  - **sonObjects** `object []`
    > 数组元素字段：
    - **customFields** `object []`
      > 数组元素字段：
      - **choiceValues** `object []`
        > 数组元素字段：
        - **choiceCode** `string`
        - **choiceValue** `string`
        - **id** `integer`
        - **isDefault** `integer`
        - **sequence** `integer`
      - **datetimeFormat** `string`
      - **decimalNumber** `integer`
      - **defaultValue** `string`
      - **editable** `integer`
      - **esField** `string`
      - **fieldCode** `string`
      - **fieldEsValue** `object`
      - **fieldExportValue** `object`
      - **fieldId** `integer`
      - **fieldName** `string`
      - **fieldRemind** `string`
      - **fieldType** `integer`
      - **fieldValue** `object`
      - **isRefer** `integer`
      - **isRequired** `integer`
      - **isUsed** `integer`
      - **maxLength** `integer`
      - **maxValue** `integer`
      - **objectCode** `string`
      - **reference** `string`
      - **targetType** `integer`
      - **visible** `integer`
    - **objectCode** `string` - 对象code
  - **storageCode** `string` - 关联仓位
  - **supplierCode** `string` - 供应商编号
  - **tagsList** `object []` - 设备标签
    > 数组元素字段：
    - **code** `string` - 设备编号
    - **tagsName** `string` - 标签项
    - **tagsValue** `string` - 标签值
  - **unitName** `string` - 存储单位名称
  - **updatedAt** `string` - 更新时间
  - **updatedTime** `integer` - 更新时间Long
  - **useAge** `integer` - 使用年限
  - **useAgeUnit** `string` - 使用年限单位
  - **userCodesStr** `string` - 负责人编号
- **fieldPermission** `object` - 字段权限管理
  > 对象字段：
  - **encoding** `string`
  - **noAccess** `string []`
  - **readonly** `string []`
- **message** `string` **必填** `成功` - 返回信息
- **needCheck** `integer` - 是否需要二次确认 0 强管控 不需要确认 1 弱管控 需要用户两次确认
- **subCode** `string` `100001` - 错误码

## 返回示例

```json
{
  "code": 200,
  "data": {
    "brandModel": "string",
    "businessType": "string",
    "childrenCodeStr": "string",
    "classificationCode": "string",
    "code": "string",
    "codeEntityLinkCode": "string",
    "createdAt": "string",
    "createdTime": 0,
    "customFields": [
      {
        "choiceValues": [
          {
            "choiceCode": "string",
            "choiceValue": "string",
            "id": 0,
            "isDefault": 0,
            "sequence": 0
          }
        ],
        "datetimeFormat": "string",
        "decimalNumber": 0,
        "defaultValue": "string",
        "editable": 0,
        "esField": "string",
        "fieldCode": "string",
        "fieldEsValue": {},
        "fieldExportValue": {},
        "fieldId": 0,
        "fieldName": "string",
        "fieldRemind": "string",
        "fieldType": 0,
        "fieldValue": {},
        "isRefer": 0,
        "isRequired": 0,
        "isUsed": 0,
        "maxLength": 0,
        "maxValue": 0,
        "objectCode": "string",
        "reference": "string",
        "targetType": 0,
        "visible": 0
      }
    ],
    "departmentCodesStr": "string",
    "enableDateStr": "string",
    "enterFactoryDateStr": "string",
    "externalNo": "string",
    "id": 0,
    "inputStorageCodes": "string",
    "locationCode": "string",
    "name": "string",
    "outFactoryDateStr": "string",
    "outputStorageCodes": "string",
    "paramsDOList": [
      {
        "code": "string",
        "paramsCode": "string",
        "paramsDownApi": "string",
        "paramsFloorLimit": 0,
        "paramsLowerLimit": 0,
        "paramsReadApi": "string",
        "paramsStandard": 0,
        "paramsTopLimit": 0,
        "paramsUpperLimit": 0
      }
    ],
    "parentCode": "string",
    "planScrapDate": "string",
    "remark": "string",
    "serialNo": "string",
    "sonObjects": [
      {
        "customFields": [
          {
            "choiceValues": [
              {
                "choiceCode": "string",
                "choiceValue": "string",
                "id": 0,
                "isDefault": 0,
                "sequence": 0
              }
            ],
            "datetimeFormat": "string",
            "decimalNumber": 0,
            "defaultValue": "string",
            "editable": 0,
            "esField": "string",
            "fieldCode": "string",
            "fieldEsValue": {},
            "fieldExportValue": {},
            "fieldId": 0,
            "fieldName": "string",
            "fieldRemind": "string",
            "fieldType": 0,
            "fieldValue": {},
            "isRefer": 0,
            "isRequired": 0,
            "isUsed": 0,
            "maxLength": 0,
            "maxValue": 0,
            "objectCode": "string",
            "reference": "string",
            "targetType": 0,
            "visible": 0
          }
        ],
        "objectCode": "string"
      }
    ],
    "storageCode": "string",
    "supplierCode": "string",
    "tagsList": [
      {
        "code": "string",
        "tagsName": "string",
        "tagsValue": "string"
      }
    ],
    "unitName": "string",
    "updatedAt": "string",
    "updatedTime": 0,
    "useAge": 0,
    "useAgeUnit": "string",
    "userCodesStr": "string"
  },
  "fieldPermission": {
    "encoding": "string",
    "noAccess": [
      "string"
    ],
    "readonly": [
      "string"
    ]
  },
  "message": "成功",
  "needCheck": 0,
  "subCode": "100001"
}
```