基于HTTP协议的连接¶
设备开发者可以通过HTTP协议,将设备采集的实时数据上报到EnOS。基于HTTP协议的连接,目前仅支持设备向EnOS上报数据,但支持文件类型数据的上传与下载。
设备通过HTTP协议与EnOS通信的流程如下:
设备端集成设备认证密钥 (Product key, Device key, Device secret)。
设备通过HTTP协议或HTTPS协议接入EnOS,并将数据推送到EnOS。
应用开发者可以通过EnOS的API获取设备数据、修改测点属性、调用设备服务,并将获取的数据呈现在应用中。
HTTP协议版本¶
通道安全¶
EnOS平台同时支持HTTP协议与HTTPS协议。针对需要通道安全的场景,设备可以选用HTTPS保证通道安全。
说明与限制¶
Topic规范和MQTT的Topic规范一致。使用HTTP协议连接,上报数据请求:
https://{HTTP-Broker-URL}/topic/{Topic}
。其中,Topic变量的值与MQTT连接通信的Topic相同。有关MQTT连接topic的相关信息,参见基于MQTT协议的设备连接(实时数据)。HTTP请求消息体的格式与返回消息体的格式和MQTT的规范一致。
HTTP返回消息中的错误码与MQTT的规范一致。
HTTP请求只支持POST方式。
设备认证请求的HTTP header中的
Content-Type
必须为application/json
。设备信息上报的HTTP header中的
Content-Type
目前必须为application/octet-stream
。
资源准备¶
设备文件存储资源
使用设备文件存储服务前,需确保OU已经通过 EnOS管理门户 > 资源管理 页面申请 设备文件存储 资源。有关申请资源的详细信息,参见 设备文件存储。
相关链接¶
有关HTTP连接的详细信息,参见HTTP连接通信。
你可以使用EnOS IoT SDK for HTTP实现基于HTTP协议的设备接入。
如果不使用EnOS提供的SDK,你也可以基于本文档并复用基于MQTT协议的设备连接(实时数据)中有关设备连接的相关topic详细参数,连接设备至EnOS并上送测点信息。