连接信息

  • 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>

字段 描述
OrgID 您的组织ID,可以从后台中的Organization页面中获取。
DeviceEUI 传感器设备唯一标识
Channel 一个设备上的物理接口,用于连接传感器,默认为1
Reserved 预留字段
MeasurementID 测量值ID,具体测量值的清单详见附录

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

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

消息主体

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

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

字段 描述
value 传感器的测量数值
timestamp 数据的时间戳,单位为毫秒

接收设备状态数据

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

字段 描述
OrgID 您的组织ID,可以从后台中的Organization页面中获取。
DeviceEUI 传感器设备唯一标识
Reserved 预留字段
StatusID 状态值ID,具体设备状态ID清单详见附录

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

消息主体

{
    "value": "437",
    "timestamp": "1544151922137"
}
字段 描述
value 状态值内容
timestamp 数据的时间戳,单位为毫秒