新增设备台账基础信息（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": "创建设备信息成功！"
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
