基于 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
。
资源准备¶
设备文件存储资源
使用设备文件存储服务前,需确保 OU 已经通过 EnOS 管理控制台 > 资源管理 页面申请 设备文件存储 资源。有关申请资源的详细信息,参见 设备文件存储。
相关链接¶
有关 HTTP 连接的详细信息,参见 HTTP连接通信。
你可以使用 EnOS IoT SDKs 实现基于 HTTP 协议的设备接入。