- 最新动态
- 功能总览
- 服务公告
- 计费说明
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- 开发指南
-
API参考
- 应用侧API参考
- 设备侧MQTT/MQTTS接口参考
- 设备侧HTTPS接口参考
- 设备侧LwM2M接口参考
- 安全隧道WebSocket接口参考
- 模组AT指令参考
- 修订记录
- SDK参考
- 场景代码示例
-
常见问题
- 热门问题
-
方案咨询
- 连接IoT平台的业务场景有哪些?
- 设备管理服务和设备接入服务合一后的差异点是什么?
- IAM子用户或子项目是否可以开通物联网平台服务?
- 物联网平台支持在华为云的哪些区域开通?
- 华为是否提供模组/硬件终端/应用软件等?
- IAM用户访问API提示没有权限?(是否区分版本?)
- 创建规则或者设置资源文件存储时候提示赋予Security Administrator权限
- 物联网平台设置默认资源空间的规则是什么?
- 设备接入服务如何获取设备数据?
- 物联网平台的资源空间和设备可以无限创建吗?
- 物联网平台支持批量注册设备吗?
- 物联网平台对应用侧和设备侧在开发或使用时有限制吗?
- 物联网平台支持的DTLS加密算法有哪些?
- 物联网平台支持二进制大小端模式切换吗?
- 什么是NB-IoT?
- 物联网平台支持的硬件架构和使用的相关组件有哪些?
- 如何获取平台接入地址?
- 设备集成相关问题
- 设备侧SDK相关问题
- 设备发放相关问题
- LWM2M/CoAP接入相关问题
- MQTT接入相关问题
- 泛协议接入相关问题
- 物模型相关问题
- 消息通信相关问题
- 订阅推送相关问题
- 编解码插件相关问题
- OTA升级相关问题
- 应用集成相关问题
- 实例管理相关问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
设备属性上报
接口说明
用于设备按产品模型中定义的格式将属性数据上报给平台。
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,只允许字母、数字、下划线(_)、连接符(-)的组合。 |
services |
是 |
List<ServiceProperty> |
Body |
参数解释: 设备服务数据列表。 |
请求示例
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 |