设备属性上报

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

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

接口描述

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

接口地址

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

请求参数

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

body 说明

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

返回参数

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

错误码

参考 错误码