基于 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 相同。 - HTTP 请求消息体的格式与返回消息体的格式和 MQTT 的规范一致。
- HTTP 返回消息中的错误码与 MQTT 的规范一致。
- HTTP 请求只支持 POST 方式。
- 设备认证请求的 HTTP header 中的
Content-Type
必须为application/json
。 - 设备信息上报的 HTTP header 中的
Content-Type
目前必须为application/octet-stream
。
相关链接¶
- 有关 HTTP 连接的详细信息,参见 HTTP连接通信。
- 你可以使用 EnOS IoT SDKs 实现基于 HTTP 协议的设备接入。