Data OpenStream API方法说明

连接信息

• Host:
  中国站：sensecap-openstream.seeed.cn
  国际站：sensecap-openstream.seeed.cc
• 端口：MQTT的端口：1883 ；MQTT Over WebSocket的端口：8083。
• Client ID：格式为 org-<Organization ID>-<Random ID> <Orgnization ID> 可以在您的后台Organization页面中获取； <Random ID> 使用您自己编写的ID（支持数字和小写字母）。
• Username：格式为org-<Organization ID>，<Organization ID>可以在您的云平台“安全/API访问密钥”页面中获取（参考快速入门）。
• Password：在您的云平台“安全/API访问密钥”页面中获取“API访问密钥”（参考快速入门）。

发布和订阅模型

SenseCAP Data OepnStream API 服务实现了标准化的发布/订阅模型，平台通过MQTT代理实现了该模型，并具有端到端的消息交互通信功能。该服务还支持MQTT Over Websocket标准协议。

通过subscribe方法，您可以订阅并监听设备上报的传感器遥测数据等消息。

消息主题

接收设备遥测数据

主题格式：/device_sensor_data/<OrgID>/<DeviceEUI>/<Channel>/<Reserved>/<MeasurementID>

主题可以指定过滤条件，以实现对指定设备，通道和远程测量数据类型的监听。 例如，如果您只想侦听设备ID为“2F000000000000”的设备，可以用2F000000000000替换字段<DeviceEUI>。

上面的“2F000000000000”设备必须是已经绑定到您账号下的设备。而且<OrgID>字段是必填的。

消息主体

{
    "value": 437,
    "timestamp": "1544151922137"
}

这是一个由设备上传的传感器远程测量数据消息，其符合JSON格式并且可以被JSON解析器解析。 通常，对于大多数功能需求，主体需要与主题中的某些字段结合一起使用。

接收设备状态数据

主题格式：/device_status_event/<OrgID>/<DeviceEUI>/<Reserved>/<StatusID>

请依照设备状态ID列表订阅需要的StatusID，避免订阅到意料之外的ID

消息主体

{
    "value": "437",
    "timestamp": "1544151922137"
}