更新设备台账信息(API名称:updateOpenDeviceInfo)
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地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
|
POST |
https://appcube域名/service/ISDP__productionMeans/1.0.0/updateOpenDeviceInfo |
OpenAPI |
application/json |
请求参数
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
deviceType |
String |
是 |
设备类型 |
|
deviceInfo |
String |
是 |
设备信息 |
|
fieldName |
String |
是 |
设备字段“显示名称” |
|
fieldType |
String |
否 |
字段类型 |
|
fieldValue |
String |
否 |
字段值 |
更新时按照“设备名称+设备编码”为唯一识别
|
字段名称 |
字段类型 |
是否必填 |
说明 |
|---|---|---|---|
|
设备类型 |
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 |
响应描述。 |
请求示例
{
"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": "修改设备信息成功!"
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。