Skip to content

功能概述

更新硬件设备接口

  • 更新硬件设备接口

接口访问

接口地址

system/manage/device/update

请求方式 Method

PUT

Header - Authorization Type : Bearer Token

属性类型长度必填默认值说明访问版本
tokenstring32true用户身份标识令牌-

请求参数

属性类型长度必填默认值说明
deviceNumberstring256false不传默认不修改设备编号
aliasstring256false不传默认不修改设备别名
gatewayIDint64false不传默认不修改网关ID
isOnlineint64false不传默认不修改设备是否在线,0-否 1-是
bindTimestring256false不传默认不修改绑定时间
activationTimestring256false不传默认不修改激活时间
lastOnlineTimestring256false不传默认不修改最后在线时间
hardwareTypeint64true0设备类型,1-门锁 2-电表 3-水表
hardwareModelstring256false不传默认不修改硬件型号
switchStatusint64false不传默认不修改硬件开关状态
hardwareIDinr64true0硬件ID

请求示例

{
    "hardwareID":2,
    "alias":"水表新增测试修改",
    "gatewayID":6,
    "isOnline":1,
    "bindTime":"2025-11-04 14:43:01",
    "activationTime":"2025-11-04 14:43:01",
    "lastOnlineTime":"2025-11-04 14:43:01",
    "hardwareType":3,
    "hardwareModel":"",
    "switchStatus":0
}

返回值

属性类型必填描述
responseobjecttrue响应内容
response.Codestringtrue响应码(例如:"200")
response.Messagestringtrue响应信息(例如:"Success")
requestIdstringtrue请求唯一 ID(用于排查问题)

返回示例

{
    "response": {
        "Code": "200",
        "Message": "Success"
    },
    "requestId": "d9531db7-f0ca-4775-b3c7-886e166b355d"
}

错误码

错误码说明解决方案
92001硬件设备类型错误检查传入参数
92002硬件ID不能为空检查传入参数
404Fail代码报错