OneNET设备HTTP数据上传接口规范详解

"设备HTTP协议上传数据到OneNET接口规范1" 本文档主要介绍了设备如何使用HTTP协议将数据上传到OneNET平台，遵循标准HTTP方法进行资源的创建、读取、更新和删除（CURD）操作，并且使用JSON格式作为API的输入输出。OneNET平台在接收到设备的数据后，会根据接口规范处理这些数据，例如自动创建数据流和数据点，如果必要的话。同时，文档中提到了错误信息将以JSON格式输出，并提供了支持的返回码列表。 在HTTP报文格式示例中，设备可以一次性上传多个数据流，每个数据流内可以包含多个数据点。数据点由时间（at字段，可选，若为空则取当前时间）和值（value字段，可以是整型或字符串等不同类型的JSON对象）组成。如果存在相同时间的数据点，后面的会覆盖前面的。此外，文档还提到，为了流量优化，支持在请求URL中添加`type`字段来指定简写方式，目前支持3、4、5三种简写形式，以减少数据传输量。 简写方式示例： 1. `type=3`：在URL中直接指定数据流和对应的值，例如： ``` http://<API_ADDRESS>/devices/<device_id>/datapoints?type=3 {“temperature”:22.5,”humidity”:”95.2%”} ``` 这意味着向数据流`temperature`增加一个值为22.5的数据点，向数据流`humidity`增加一个值为95.2%的数据点。 2. `type=4`：在URL中指定数据流、时间戳和值，例如： ``` http://<API_ADDRESS>/devices/<device_id>/datapoints?type=4 {“temperature”:{“2015-03-22T22:31:12”:22.5}} ``` 这表示在数据流`temperature`中增加一个时间戳为2015年3月22日22时31分12秒，值为22.5的数据点。 简写方式的使用简化了设备与OneNET平台之间的通信，使得数据上传更为高效。 需要注意的是，设备在上传数据前需要在OneNET门户上注册并获取相应的API地址和设备ID。数据流的创建可以通过API完成，如果上传的数据流不存在，OneNET平台会自动创建。对于数据点的at字段，如果不提供，系统会自动使用服务器接收到数据时的时间，精确到毫秒。如果同一数据流有多条无时间戳的数据点，只有最后一条会被保存。 总结来说，设备HTTP协议上传数据到OneNET接口规范1是关于如何利用HTTP协议和JSON格式，遵循特定的简写规则，将设备数据安全、高效地上传到OneNET云平台的指南。这个规范对于物联网(IoT)设备开发者而言至关重要，因为它定义了设备与云服务之间数据交互的标准格式和行为。