检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
应用侧API参考 使用前必读 如何调用API API概览 API 权限与授权项 应用示例 附录
s_token在未超期前保留30s，30s之后失效。 设备消息上报 API 说明 设备消息上报 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 设备属性上报 API 说明 设备属性上报 用于设备按产品模型中定义的格式将属性数据上报给平台。
如何调用API 构造请求 认证鉴权 返回结果 父主题： 应用侧API参考
查询指定设备加入的设备组列表 应用服务器调用该接口查询设备加入的设备组列表。 设备消息 API 说明 查询设备消息 查询指定设备下的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。 下发设备消息 向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对
上行业务消息传输 /19/1/0 BinaryAppDataContainer Data 下行业务数据传输 BinaryAppDataContainer对象：为简化设备厂商定义并使用LwM2M对象的复杂度，华为定义了19对象，由芯片或模组实现，设备只需要调用AT接口或函数接口来实现
则三部分。支持转发至“数据接入服务DIS”、“分布式消息服务 Kafka”、“对象存储服务 OBS”、“应用与数据集成平台 ROMA Connect”、“第三方应用服务（HTTP推送）”、“AMQP推送消息队列”、、、。 订阅管理 订阅管理为应用服务器提供对物联网平台资源的订阅功
可选 String 参数解释： 消息名称，可不填写，做说明用。 id 可选 String 参数解释： 消息的唯一标识，用于区分与查找消息。如不填写系统会自动生成一个消息ID，消息ID不可重复。 content 必选 String 参数解释： 消息内容，可以为base64编码格式。
下发设备消息 功能介绍 物联网平台可向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果，建议用户应用通过订阅设备消息状态变更通知，订阅后平台会将设备接收结果推送给订阅的应用。
查询设备消息 功能介绍 应用服务器可调用此接口查询平台下发给设备的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/messages
下发广播消息 功能介绍 应用服务器可调用此接口向订阅了指定Topic的所有在线设备发布广播消息。应用将广播消息下发给平台后，平台会先返回应用响应结果，再将消息广播给设备。 注意： 此接口只适用于使用MQTT协议接入的设备。 调用方法 请参见如何调用API。 URI POST /v
查询指定消息id的消息 功能介绍 应用服务器可调用此接口查询平台下发给设备的指定消息id的消息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/messages/{message_id} 表1 路径参数
广播消息 下发广播消息 父主题： API
在消息通知服务中创建主题并添加订阅，供设备接入服务调用以发送邮件或短信。 登录华为云官方网站，访问消息通知服务。 单击“立即使用”进入消息通知服务控制台。若您未开通消息通知服务，请先开通服务。 进入“主题管理 > 主题”页面，单击“创建主题”。 输入主题名称，如“Test_1”，单击“确定”。 图2 创建主题-SMN
设备消息 下发设备消息 查询设备消息 查询指定消息id的消息 父主题： API
API 产品管理 设备管理 设备消息 设备命令 设备属性 AMQP队列管理 接入凭证管理 数据流转规则管理 流转数据 设备联动规则 设备影子 设备组管理 标签管理 实例管理 资源空间管理 批量任务 设备CA证书管理 OTA升级包管理 广播消息 设备隧道管理 数据流转积压策略管理 数据流转流控策略管理
设备消息 设备消息上报 平台消息下发 父主题： 设备侧MQTT/MQTTS接口参考
示例二：给指定设备下发消息 场景描述 本章节指导用户通过API给指定设备下发消息。API的调用方法参见如何调用API。 涉及接口 查询设备列表：确定待下发消息的设备。 下发设备消息：给指定设备下发消息。 查询指定消息id的消息：确认消息下发结果。 操作步骤 确定待下发消息的设备。 查询设备列表
设备连接鉴权 接口说明 IoT平台设备侧支持MQTT协议的connect消息接口，鉴权通过后建立设备与平台间的MQTT连接。 参数说明 设备通过MQTT协议的connect消息进行鉴权，对于构造ClientId的各个部分信息都必须包括进去，平台收到connect消息时，会判断设备的鉴权类型和密码摘要算法。
获取到access_token之后，可以消息/属性上报等功能。其中access_token放于消息头中，下面示例为上报属性： 图3 上报属性 图4 上报属性 https接口介绍 物联网平台的接口如下表所示： 接口分类 用途 接口 设备鉴权相关接口 设备鉴权 /v5/device-auth 设备消息相关接口 设备消息上报
设备消息上报通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:device.message，Event:report）、创建规则动作、修改规则触发条件接口配置并激活规则后，当设备上报消息数据时，物联网平台会向应用服务器推送通知消息。 URI POST
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
