修改设备基础属性

更新时间:2023-11-23 06:40:58下载pdf

本文介绍修改设备基础属性的 API。

接口描述

修改设备基础属性。你可以修改设备名称、图标以及经纬度等信息。

接口地址

POST: /v2.0/cloud/thing/{device_id}/attribute

请求参数

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

body 说明

参数名类型参数位置是否必填说明
typeIntegerbodytrue设备基础属性的类型。
  • 1:修改设备名称。
  • 2:修改设备图标属性。
  • 3:修改经纬度属性。经纬度格式为 纬度:经度,以英文半角冒号分隔。例如,120.15:30.48
dataStringbodytrue数据。

返回参数

参数名类型说明
resultBoolean操作是否成功。
  • true:操作成功。
  • false:操作失败。
successBoolean接口调用是否成功。
  • true:调用成功。
  • false:调用失败。
tLong时间戳。
tidString链路 ID。

请求示例

POST: /v2.0/cloud/thing/6c19224514c02f7490****/attribute
{
  "type": 1,
  "data": "主卧灯"
}

返回示例

{
    "tid": "b8a2b49abbbc11eda71e169efc83a172",
    "result": true,
    "t": 1678065474602,
    "success": true
}

错误码

参考 错误码

调用频率限制

参考 调用频率限制