
# 更新设备台账信息（API名称：updateOpenDeviceInfo）
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*域名/service/ISDP__productionMeans/1.0.0/updateOpenDeviceInfo | OpenAPI | application/json |
   
#### 请求参数
| 参数         | 类型     | 是否必填 | 描述         |
|:---|:---|:---|:---|
| deviceType | String | 是    | 设备类型       |
| deviceInfo | String | 是    | 设备信息       |
| fieldName  | String | 是    | 设备字段"显示名称" |
| fieldType  | String | 否    | 字段类型       |
| fieldValue | String | 否    | 字段值        |
   
![](https://support.huaweicloud.com/api-isdp/public_sys-resources/caution_3.0-zh-cn.png)
更新时按照"设备名称+设备编码"为唯一识别
| 字段名称  | 字段类型   | 是否必填      | 说明                           |
|:---|:---|:---|:---|
| 设备类型  | String | 是         | 设备类型必填，填写设备类型全路径。例：主设备\>设备1  |
| 设备名称  | String | 是         | 设备名称唯一                       |
| 设备编码  | String | 是         | 设备编码唯一                       |
| 父设备名称 | String | 否（默认为"否"） | -                            |
| 父设备编码 | String | 否（默认为"否"） | -                            |
| 设备品牌  | String | 否（默认为"否"） | -                            |
| 设备型号  | String | 否（默认为"否"） | -                            |
| 资产编号  | String | 否（默认为"否"） | -                            |
| 出厂日期  | Date   | 否（默认为"否"） | 年月日格式（yyyy-MM-dd），为空时传null。  |
| 设备状态  | String | 否（默认为"否"） | 正常、带病运行、故障                   |
| 工作状态  | String | 否（默认为"否"） | 运行、停机                        |
| 归属部门  | String | 否（默认为"否"） | 如果组织名称有重复，填写组织名称\<组织编码\>。    |
| 责任人   | String | 否（默认为"否"） |                              |
| 区域位置  | String | 否（默认为"否"） | 填写区域位置全路径，如：陕西省\>西安市。        |
| 启用日期  | Date   | 否（默认为"否"） | 年月日格式（yyyy-MM-dd），为空时传null。  |
| 供应商名称 | String | 否（默认为"否"） | 如果供应商名称重复，请填写供应商名称\<供应商编码\>。 |
| 客户名称  | String | 否（默认为"否"） | 如果客户名称重复，请填写客户名称\<客户编码\>。    |
| 设备数量  | Number | 否（默认为"否"） | 为空时默认为"1"。                   |
| 单位    | String | 否（默认为"否"） | 个、台、辆、张                      |
| 采购单价  | String | 否（默认为"否"） |                              |
| 技术参数  | String | 否（默认为"否"） | 最大支持500字                     |
   
#### 响应参数
| 参数      | 类型     | 描述                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| code    | String | 响应状态码。 - 0：成功  - 其他：失败   |
| message | String | 响应描述。                                                                                                                                                                                                                                                                                                                                                                                               |
   
#### 请求示例
```
{
                          "deviceType" : "主设备1231312312313",
                          "deviceInfo" : [{
                                             "fieldName" : "设备类型",
                                             "fieldType" : 1,
                                             "fieldValue" : "123"
                                    },{
                                             "fieldName" : "设备编码",
                                             "fieldType" : 1,
                                             "fieldValue" : "0909test1"
                                    }, {
                                             "fieldName" : "设备名称",
                                             "fieldType" : 1,
                                             "fieldValue" : "0909test1"
                                    },{
                                             "fieldName" : "设备状态",
                                             "fieldType" : 1,
                                             "fieldValue" : "正常"
                                    }, {
                                             "fieldName" : "设备品牌2222",
                                             "fieldType" : 1,
                                             "fieldValue" : "123"
                                    }, {
                                             "fieldName" : "资产编号",
                                             "fieldType" : 1,
                                             "fieldValue" : "123"
                                    }, {
                                             "fieldName" : "工作状态",
                                             "fieldType" : 1,
                                             "fieldValue" : "运行"
                                    }, {
                                             "fieldName" : "责任人",
                                             "fieldType" : 1,
                                             "fieldValue" : "圈圈"
                                    }, {
                                             "fieldName" : "启用日期",
                                             "fieldType" : 4,
                                             "fieldValue" : "2022-09-09"
                                    }, {
                                             "fieldName" : "出厂日期",
                                             "fieldType" : 4,
                                             "fieldValue" : "2022-09-09"
                                    }, {
                                             "fieldName" : "供应商名称",
                                             "fieldType" : 1,
                                             "fieldValue" : "0816test"
                                    }, {
                                             "fieldName" : "客户名称",
                                             "fieldType" : 1,
                                             "fieldValue" : ""
                                    }, {
                                             "fieldName" : "设备数量",
                                             "fieldType" : 8,
                                             "fieldValue" : 13
                                    },{
                                             "fieldName" : "计量单位",
                                             "fieldType" : 1,
                                             "fieldValue" : "台"
                                    }, {
                                             "fieldName" : "采购单价",
                                             "fieldType" : 8,
                                             "fieldValue" : 1
                                    }, {
                                             "fieldName" : "货币",
                                             "fieldType" : 1,
                                             "fieldValue" : "元"
                                    },{
                                             "fieldName" : "技术参数",
                                             "fieldType" : 7,
                                             "fieldValue" : "123"
                                    }, {
                                             "fieldName" : "图片",
                                             "fieldType" : 1,
                                             "fieldValue" : "123"
                                    }, {
                                             "fieldName" : "技术资料1",
                                             "fieldType" : 1,
                                             "fieldValue" : "123"
                                    }, {
                                             "fieldName" : "水电费232232",
                                             "fieldType" : 1,
                                             "fieldValue" : "123"
                                    }, {
                                             "fieldName" : "234234",
                                             "fieldType" : 3,
                                             "fieldValue" : "枚举值01"
                                    }, {
                                             "fieldName" : "区域位置",
                                             "fieldType" : 1,
                                             "fieldValue" : ""
                                    }, {
                                             "fieldName" : "文本666",
                                             "fieldType" : 1,
                                             "fieldValue" : "123"
                                    },{
                                             "fieldName" : "测试",
                                             "fieldType" : 1,
                                             "fieldValue" : "123"
                                    },{
                                             "fieldName" : "测试123123",
                                             "fieldType" : 7,
                                             "fieldValue" : "123"
                                    }
                          ]
                   }
```
#### 响应示例
```
{
    "code": "0",
    "message": "修改设备信息成功！"
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。
