更新设备

更新时间:2023-06-15 05:34:56

本文介绍更新设备的 API。

接口描述

根据设备 ID,更新设备信息。

接口地址

PUT: /v1.0/iot-03/3rdcloud/devices/{device_id}

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue涂鸦设备 ID。

body 说明

参数名类型参数位置是否必填说明
device_nameStringbodyfalse设备名称,⻓度不超过 50 个字符。
optionsObjectbodyfalse设备扩展信息,包含:
  • installLocation:安装地址。
  • outProjectId:设备在合作⼚商云的项⽬ ID。
  • mac:MAC 地址。
  • extendData:JSON,如:{"roomNo":"16"}, 其中 roomNo 为酒店房间号。

返回参数

参数名类型说明
resultBoolean响应结果。
codeString参见错误码,成功为空。
msgString请求失败的信息,成功为空。
successBoolean请求是否成功。
  • true:成功。
  • false:失败。
tLong请求响应的时间戳,长度 13 位。

请求示例

PUT: /v1.0/iot-03/3rdcloud/devices/6cf4171005d11e2ca7****
{
  "device_name": "测试设备",
  "options": {
    "mac": "48ea63fd****",
    "installLocation": "杭州市⻄湖区蒋墩路****"
  }
}

返回示例

{
    "result": true,
    "t": 1650004025390,
    "success": true
}

错误码

参考 错误码