设备功能点上报

更新时间:2023-06-20 12:39:05

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

接口描述

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

接口地址

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

请求参数

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

body 说明

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

返回参数

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

result 说明

参数名类型说明
resultObject返回内容对象。
codeString参见错误码,成功为空。
msgString请求失败的信息,成功为空。
successBoolean请求是否成功。
  • true:成功
  • false:失败
tLong请求响应的时间戳,长度 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
}

错误码

参考 错误码