更新设备

更新时间:2024-01-04 09:36:35下载pdf

本文介绍更新设备的 API。

接口描述

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

接口地址

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

请求参数

参数名 类型 参数位置 是否必填 说明
device_id String uri true 涂鸦设备 ID。

body 说明

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

返回参数

参数名 类型 说明
result Boolean 响应结果。
code String 参见错误码,成功为空。
msg String 请求失败的信息,成功为空。
success Boolean 请求是否成功。
  • true:成功。
  • false:失败。
t Long 请求响应的时间戳,长度 13 位。

请求示例

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

返回示例

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

错误码

参考 错误码