设备属性上报

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

本文介绍设备属性上报的 API。

接口描述

设备上报自身的属性状态信息。

接口地址

POST: /v1.0/iot-03/3rdcloud/devices/{device_id}/property/report

请求参数

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

body 说明

参数名类型参数位置是否必填说明
msg_idStringbodytrue本次请求的唯⼀标识, ⻓度不超过 32 个字符。
dataObjectbodytrue属性上报内容。

返回参数

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

请求示例

POST: /v1.0/iot-03/3rdcloud/devices/6cf4171005d11e2ca7****/property/report
{
  "msg_id": "ed23rty159292****",
  "data": {
    "resolution_ratio": {
      "value": 1080,
      "time": 1592920221212
    }
  }
}

返回示例

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

错误码

参考 错误码