新增设备台账基础信息（API名称：addOpenDeviceInfo）
OC环境appcube域名固定为：https://app.intouchmarket.huawei.com
功能介绍
用于与客户系统对接新增设备台账信息。
相关接口
| 接口名称 | 调用说明 |
|---|---|
| 调用该接口获取到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地址 | 服务架构 | 消息体类型 |
|---|---|---|---|
| GET | https://appcube域名/service/ISDP__productionMeans/1.0.0/addOpenDeviceInfo | OpenAPI | application/json |
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| deviceInfoList | 对象集合 | 是 | 设备信息集合 |
| deviceType | String | 是 | 设备类型 |
| deviceInfo | 对象集合 | 是 | 设备信息 |
| fieldName | String | 否 | 设备字段“显示名称” |
| fieldType | String | 否 | 字段类型。 1：文本 2：单枚举 3：多枚举 4：日期 5：时间 6：日期时间 7：长文本 8：数字 |
| fieldValue | String | 否 | 字段值。 |
新增设备时包含基础字段、扩展字段。基础字段默认配置见下表，扩展字段由用户根据设备类型从扩展信息库动态引入
基础字段、扩展字段是否必填依赖对应“设备类型”在“基础配置”系统中的设置，以系统实际配置为准。
（点击跳转ISDP系统，具体菜单路径：“生产资料-设备管理-基础配置”）
| 字段名称 | 字段类型 | 是否必填 | 说明 |
|---|---|---|---|
| 设备类型 | 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 | 响应状态码。
|
| message | String | 响应描述。 |
请求示例
{"deviceInfoList" : [{
"deviceType" : "主设备1231312312313",
"deviceInfo" : [{
"fieldName" : "设备类型",
"fieldType" : 1,
"fieldValue" : "123"
}, {
"fieldName" : "设备名称",
"fieldType" : 1,
"fieldValue" : "0909test1"
}, {
"fieldName" : "设备编码",
"fieldType" : 1,
"fieldValue" : "0909test1"
}, {
"fieldName" : "父设备编码",
"fieldType" : 1,
"fieldValue" : "0907test2"
}, {
"fieldName" : "父设备名称",
"fieldType" : 1,
"fieldValue" : "0907test2"
}, {
"fieldName" : "设备品牌",
"fieldType" : 1,
"fieldValue" : "123"
}, {
"fieldName" : "设备型号",
"fieldType" : 1,
"fieldValue" : "001"
}, {
"fieldName" : "资产编号",
"fieldType" : 1,
"fieldValue" : "123"
}, {
"fieldName" : "出厂日期",
"fieldType" : 4,
"fieldValue" : "2022-09-09"
}, {
"fieldName" : "设备状态",
"fieldType" : 1,
"fieldValue" : "正常"
}, {
"fieldName" : "工作状态",
"fieldType" : 1,
"fieldValue" : "运行"
}, {
"fieldName" : "责任人",
"fieldType" : 1,
"fieldValue" : "圈圈"
}, {
"fieldName" : "区域位置",
"fieldType" : 1,
"fieldValue" : "陕西省>西安市"
}, {
"fieldName" : "启用日期",
"fieldType" : 4,
"fieldValue" : "2022-09-09"
}, {
"fieldName" : "供应商名称",
"fieldType" : 1,
"fieldValue" : "0816test"
}, {
"fieldName" : "客户名称",
"fieldType" : 1,
"fieldValue" : "fctest<fctest2>"
}, {
"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" : "文本666",
"fieldType" : 1,
"fieldValue" : "123"
}, {
"fieldName" : "水电费232232",
"fieldType" : 1,
"fieldValue" : "123"
}, {
"fieldName" : "测试",
"fieldType" : 1,
"fieldValue" : "123"
}, {
"fieldName" : "测试123123",
"fieldType" : 7,
"fieldValue" : "123"
}
]
}
]
} 响应示例
{
"code": "0",
"message": "创建设备信息成功！"
} 状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
