基于 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 管理控制台 > 资源管理 页面申请 设备文件存储 资源。有关申请资源的详细信息，参见 设备文件存储。

相关链接