上行消息集成

上行消息集成概述

在 “SiX物联网平台” 中，上行消息集成是指向网络连接设备发送指令或数据的过程。虽然主要的通信机制通常是持久的 MQTTs 连接（允许 App 用户通过 MQTT 代理发布消息），但在某些场景下需要使用 REST API 方式。这种基于 API 的方法特别适用于第三方服务集成，使外部平台无需维持恒定的消息总线连接即可与设备进行交互。

提示

对于语音平台集成（如小度或天猫精灵），这种基于 API 的方式非常理想。这些平台通常使用云对云（Cloud-to-Cloud）的回调函数（Webhooks）来转发语音指令；因此，REST API 作为桥梁，将这些外部 Web 请求转换为针对联网设备的实际操作指令。

集成步骤

1. 创建产品专属的上行消息集成密钥

要发送上行消息，您必须首先创建一个专门用于此目的的集成密钥。该密钥用于通过 SiX统一认证&授权 交换访问令牌（Access Token）。身份验证通过后，该令牌将允许您的服务调用特定的 API 以将数据传输至设备。

注意

上行消息集成密钥受到 “用途” 和 “特定产品” 校验的严格限制。它们仅专用于上行数据流，不能用于设备注册或其他未经授权的API操作。

如何使用集成密钥：

有关如何使用集成密钥的通用指南，请参考：通过API Key进行集成

2. 调用API发送设备消息

调用指定的API端点将数据负载（Payload）传输至目标设备。

信息

对于联邦物联网产品，系统利用与外部云平台（如 AWS IoT Core）的IAM 联邦身份认证。在这种情况下，消息会自动且安全地路由并转发至相应的云提供商，最终送达设备。

您也可以选择直接使用目标云平台提供的原生消息机制向设备发送消息。

3. 监控消息历史与集成状态

您可以实时监控特定集成密钥的状态，并查看通过该通道发送的所有历史消息日志。这为您提供了交付成功率的全面可见性，并有助于排查您的服务与设备之间的通信问题。