简体中文
简体中文
English
联系我们
注册
登录

更新设备

更新时间:2022-09-06 03:36:32

本文介绍更新设备的 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响应结果
codeBoolean参见错误码,成功为空
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
}

错误码

参考 错误码