设备功能点上报

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

本文介绍设备功能点上报的 API。

接口描述

合作厂商云上报设备功能属性。

接口地址

POST: /v1.0/cloud/thing/devices/{device_id}/datapoint/report

请求参数

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

body 说明

参数名 类型 参数位置 是否必填 说明
data Object body true 功能点上报内容。一个 data 字段里面可以传一个或者多个功能点数据。请求示例中:
  • 101119:产品功能点的DP ID。
  • value:功能点对应的值。
  • time:功能点值发生变化的时间。

返回参数

参数名 类型 说明
result FusionResult 响应结果。

result 说明

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

请求示例

POST: /v1.0/cloud/thing/devices/6cf4171005d11e2ca7****/datapoint/report
{
  "data": {
    "101": {
      "value": "online",
      "time": 1682392142000
    },
    "119": {
      "value": 80,
      "time": 1682392142000
    }
  }
}

返回示例

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

错误码

参考 错误码