"设备HTTP协议上传数据到OneNET接口规范"
设备HTTP协议上传数据到OneNET接口规范是OneNET提供的一种设备数据上传接口规范，旨在帮助设备开发者将设备数据上传到OneNET平台。该规范介绍了设备使用HTTP协议上传数据到OneNET平台的方法和格式。
设计原则
设备HTTP协议上传数据到OneNET接口规范遵循以下设计原则：
1. 使用标准HTTP方法实现资源CURD操作。
2. 采用JSON作为API输入输出。
3. 以JSON输出错误信息。
HTTP方法描述
以下是设备HTTP协议上传数据到OneNET接口规范中使用的HTTP方法：
1. POST：新增资源信息。
2. PUT：更新资源信息。
3. GET：查看资源信息。
4. DELETE：删除资源。
返回码列表
以下是设备HTTP协议上传数据到OneNET接口规范中使用的返回码列表：
1. 200 OK：在HTTP body中以JSON格式指明详细成功或错误信息。
2. 400 Bad Request：错误的请求格式。
3. 401 Not Authorized：未经授权的访问。
4. 403 Forbidden：禁止访问。
5. 404 Not Found：资源不存在。
6. 406 Not Acceptable：不接受的媒体类型。
7. 422 Unprocessable Entity：无法处理的实体。
8. 500 Internal Server Error：内部服务器错误。
9. 503 No server error：服务器不可用。
HTTP报文格式示例
以下是设备HTTP协议上传数据到OneNET接口规范中使用的HTTP报文格式示例：
示例1：
POST http://api.heclouds.com/devices/<device_id>/datapoints
HTTP头部：api-key:xxxx-ffff-zzzzz
HTTP内容：{"temperature": 22.5, "humidity": "95.2%"}
示例2：
POST http://api.heclouds.com/devices/<device_id>/datapoints?type=3
HTTP头部：api-key:xxxx-ffff-zzzzz
HTTP内容：{"temperature": 22.5, "humidity": "95.2%"}
文本数据上传
设备HTTP协议上传数据到OneNET接口规范支持文本数据上传。设备可以将文本数据上传到OneNET平台，例如温度、湿度等数据。
二进制数据上传
设备HTTP协议上传数据到OneNET接口规范也支持二进制数据上传。设备可以将二进制数据上传到OneNET平台，例如音频、视频等数据。
简写方式
为了节省流量，设备HTTP协议上传数据到OneNET接口规范支持简写方式。在请求的URL中增加type字段，指示所使用的简写方式。目前type支持3、4、5三种情况。
设备HTTP协议上传数据到OneNET接口规范提供了一种简单、灵活的方式将设备数据上传到OneNET平台，帮助设备开发者快速实现设备数据上传功能。
评论0
最新资源