# 查询设备台账信息（API名称：getDeviceList）
OC环境*appcube*域名固定为：https://app.intouchmarket.huawei.com
#### 功能介绍
用于与客户系统对接查询设备台账信息。
#### 相关接口
| 接口名称                                                                 | 调用说明                                                                                                                                                                                                                                                           |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。                                                                                                                                                                                                   |
| 鉴权方式创建oauth客户端认证凭据参考：                                                | <https://support.huaweicloud.com/api-astrozero/astrozero_api_0010.html#section0>                                                                                                                                                                               |
| 获取access_token参考                                                     | <https://support.huaweicloud.com/api-astrozero/astrozero_api_0009.html> 发送请求时需要添加header请求头(access-token) access-token: xxxxxxxxxxxxxxxxxxx |
   
#### URL
| 请求方式 | HTTPS地址                                                                                                                          | 服务架构    | 消息体类型            |
|:---|:---|:---|:---|
| POST | https://*appcube*域名/servi e/ISDP__productionMeans/1.0.0/getDeviceList | OpenAPI | application/json |
   
#### 请求参数
| 参数            | 类型      | 是否必填 | 描述                                                                                                                                                                     |
|:---|:---|:---|:---|
| typeId        | String  | 否    | 设备类型                                                                                                                                                                   |
| deviceName    | String  | 否    | 设备名称                                                                                                                                                                   |
| keyWord       | String  | 否    | 搜索关键字段(deviceName-设备类型 deviceCode-设备编码) keyWord是"deviceCode"是按照设备编码查的，如果keyWord不填或者是"deviceName"是按照设备名称查的 |
| departmentId  | String  | 否    | 所属部门id                                                                                                                                                                 |
| enableDate    | Integer | 否    | 启用日期(时间范围时间戳数组)                                                                                                                                                        |
| locationId    | Integer | 否    | 区域位置id                                                                                                                                                                 |
| customerCode  | String  | 否    | 客户编码                                                                                                                                                                   |
| supplierCode  | String  | 否    | 供应商编码                                                                                                                                                                  |
| deviceStatus  | String  | 否    | 设备状态                                                                                                                                                                   |
| workingStatus | String  | 否    | 工作状态                                                                                                                                                                   |
| parentId      | String  | 否    | 父设备id                                                                                                                                                                  |
| id            | String  | 否    | 设备id                                                                                                                                                                   |
| start         | Integer | 是    | 分页信息，表示从第几条数据开始查询                                                                                                                                                      |
| limit         | Integer | 是    | 分页信息，表示一次查询几条数据                                                                                                                                                        |
   
#### 响应参数
| 参数      | 类型     | 描述                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| resCode | String | 响应状态码。 - 0：成功  - 其他：失败   |
| resMsg  | String | 错误信息                                                                                                                                                                                                                                                                                                                                                                                                |
| result  | Object | 响应数据                                                                                                                                                                                                                                                                                                                                                                                                |
   
#### 请求示例
```
{
 "start":0,
     "limit":15,
     "deviceName":"测试",
     "keyWord":"deviceName",
     "typeId":"",
     "enableDate":[
         1665417600000,
         1666972800000
     ],
     "departmentId":"830",
     "userId":[
         391001,
         756277
     ],
     "locationId":"937185",
     "locationName":"中国",
     "customerCode":"666",
     "customerName":"\t\r\n5325235",
     "supplierCode":"0009",
     "supplierName":"0009",
     "deviceStatus":[
         "002",
         "003"
     ],
     "workingStatus":[
         "1",
         "2"
     ]
}
```
#### 响应示例
```
{
 "resCode":"0",
    "resMsg":"成功",
    "result":{
        "deviceList":[
            {
                "assetNo":"",
                "countingUnit":"U001",
                "departmentName":"",
                "deviceCode":"dz2022921asdfghjkl",
                "deviceModel":"",
                "deviceName":"dz1145142022921asdfghjkl",
                "devicePath":"cXTM000000wz3hVM9YjQ",
                "deviceQuantities":1,
                "deviceStatus":"001",
                "enableDate":null,
                "filePath":null,
                "id":"cXTM000000wz3hVM9YjQ",
                "locationName":"",
                "parentId":"0",
                "productionDate":null,
                "typeId":"czai000000vvpigRC8Dg",
                "typeName":"测试",
                "userName":"",
                "workingStatus":""
            }
        ],
        "totalCount":6
    }
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。