更新时间:2024-02-28 GMT+08:00
分享

设备属性上报

接口说明

用于设备按产品模型中定义的格式将属性数据上报给平台。

URI

请求方法

POST

URI

/v5/devices/{device_id}/sys/properties/report

传输协议

HTTPS

请求参数

名称

必选

类型

位置

说明

access_token

String

Header

参数说明: 调用设备鉴权信息返回的access_token

取值范围: 长度1-256

device_id

String

Path

参数说明: 设备ID,用于唯一标识一个设备。在注册设备时直接指定,或者由物联网平台分配获得。由物联网平台分配时,生成规则为"product_id" + "_" + "node_id"拼接而成。

取值范围: 长度不超过128,只允许字母、数字、下划线(_)、连接符(-)的组合。

取值范围: 长度1-128

services

List<ServiceProperty>

Body

参数说明: 设备服务数据列表

表1 ServiceProperty

名称

必选

类型

说明

service_id

String

参数说明: 设备服务id

properties

Object

参数说明: 设备服务的属性列表,具体字段在设备关联的产品模型中定义

event_time

String

参数说明: 设备采集数据UTC时间(格式:yyyy-MM-dd'T'HH:mm:ss.SSS'Z',如2021-08-13T10:10:10.555Z)。

设备上报数据不带该参数或参数格式错误时,则数据上报时间以平台时间为准(格式:yyyyMMdd'T'HHmmss'Z',如20230523T014506Z)。

请求示例

POST https://{endpoint}/v5/devices/{device_id}/sys/properties/report
Content-Type: application/json
access_token: ******

{
  "services" : [ {
    "service_id" : "serviceId",
    "properties" : {
      "Height" : 124,
      "Speed" : 23.24
    },
    "event_time" : "2021-08-13T10:10:10.555Z"
  } ]
}

响应示例

Status Code: 200 上报正常

错误码

HTTP状态码

HTTP状态码描述

错误码

错误码描述

错误码中文描述

400

Bad Request

IOTDA.000006

Invalid input data.

请求参数不合法

IOTDA.021104

Subdevices in the request does not exist or does not belong to the gateway.

请求中有部分子设备不存在或不属于该网关.

403

Forbidden

IOTDA.000004

Invalid access token.

非法token

IOTDA.021101

Request reached the maximum rate limit.

请求已经达到限制速率

IOTDA.021102

The request rate has reached the upper limit of the tenant, limit %s.

请求已经达到租户的限制速率

IOTDA.021105

The content reported in a single request cannot exceed 1 MB.

单次请求上报的内容不能超过1MB

分享:

    相关文档

    相关产品