基于HTTP协议的连接

设备开发者可以通过HTTP协议,将设备采集的实时数据上报到EnOS。基于HTTP协议的连接,目前仅支持设备向EnOS上报数据,但支持文件类型数据的上传与下载。

设备通过HTTP协议与EnOS通信的流程如下:

  1. 设备端集成设备认证密钥 (Product key, Device key, Device secret)。

  2. 设备通过HTTP协议或HTTPS协议接入EnOS,并将数据推送到EnOS。

应用开发者可以通过EnOS的API获取设备数据、修改测点属性、调用设备服务,并将获取的数据呈现在应用中。

HTTP协议版本

  • 支持 Hypertext Transfer Protocol — HTTP/1.0 协议,具体请参见:RFC 1945

  • 支持 Hypertext Transfer Protocol — HTTP/1.1 协议,具体请参见:RFC 2616

通道安全

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管理门户 > 资源管理 页面申请 设备文件存储 资源。有关申请资源的详细信息,参见 设备文件存储

相关链接

如果不使用EnOS提供的SDK,你也可以基于本文档并复用基于MQTT协议的设备连接(实时数据)中有关设备连接的相关topic详细参数,连接设备至EnOS并上送测点信息。