基于 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 相同。

  • HTTP 请求消息体的格式与返回消息体的格式和 MQTT 的规范一致。

  • HTTP 返回消息中的错误码与 MQTT 的规范一致。

  • HTTP 请求只支持 POST 方式。

  • 设备认证请求的 HTTP header 中的 Content-Type 必须为 application/json

  • 设备信息上报的 HTTP header 中的 Content-Type 目前必须为 application/octet-stream

资源准备

设备文件存储资源

使用设备文件存储服务前,需确保 OU 已经通过 EnOS 管理控制台 > 资源管理 页面申请 设备文件存储 资源。有关申请资源的详细信息,参见 设备文件存储

相关链接