检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
应用侧API参考 使用前必读 如何调用API API概览 API 权限与授权项 应用示例 附录
则三部分。支持转发至“数据接入服务DIS”、“分布式消息服务 Kafka”、“对象存储服务 OBS”、“应用与数据集成平台 ROMA Connect”、“第三方应用服务（HTTP推送）”、“AMQP推送消息队列”、、、。 订阅管理 订阅管理为应用服务器提供对物联网平台资源的订阅功
API概览 设备鉴权 API 说明 设备鉴权 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取a
查询指定设备加入的设备组列表 应用服务器调用该接口查询设备加入的设备组列表。 设备消息 API 说明 查询设备消息 查询指定设备下的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。 下发设备消息 向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对
如何调用API 构造请求 认证鉴权 返回结果 父主题： 应用侧API参考
上行业务消息传输 /19/1/0 BinaryAppDataContainer Data 下行业务数据传输 BinaryAppDataContainer对象：为简化设备厂商定义并使用LwM2M对象的复杂度，华为定义了19对象，由芯片或模组实现，设备只需要调用AT接口或函数接口来实现
主题名称 选择步骤4创建的主题。 协议 若需要发送邮件通知，选择“邮件”。 若需要发送短信通知，选择“短信”。 订阅终端 若协议为“邮件”，填写接收通知邮件的邮箱地址； 若协议为“短信”，输入接收短信通知的手机号码。 需要添加多个终端时，每个终端地址占1行，最多填写10行。 配置设备接入服务
查询设备消息 功能介绍 应用服务器可调用此接口查询平台下发给设备的消息，平台为每个设备默认最多保存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给指定设备下发消息。API的调用方法参见如何调用API。 涉及接口 查询设备列表：确定待下发消息的设备。 下发设备消息：给指定设备下发消息。 查询指定消息id的消息：确认消息下发结果。 操作步骤 确定待下发消息的设备。 查询设备列表
物联网平台可向设备下发消息，应用服务器可调用此接口向指定设备下发消息，以实现对设备的控制。应用将消息下发给平台后，平台返回应用响应结果，平台再将消息发送给设备。平台返回应用响应结果不一定是设备接收结果，建议用户应用通过订阅设备消息状态变更通知，订阅后平台会将设备接收结果推送给订阅的应用。 注意： 此接口适用于MQT
API 产品管理 设备管理 设备消息 设备命令 设备属性 AMQP队列管理 接入凭证管理 数据流转规则管理 流转数据 设备联动规则 设备影子 设备组管理 标签管理 实例管理 资源空间管理 批量任务 设备CA证书管理 OTA升级包管理 广播消息 设备隧道管理 数据流转积压策略管理 数据流转流控策略管理
设备连接鉴权 接口说明 IoT平台设备侧支持MQTT协议的connect消息接口，鉴权通过后建立设备与平台间的MQTT连接。 参数说明 设备通过MQTT协议的connect消息进行鉴权，对于构造ClientId的各个部分信息都必须包括进去，平台收到connect消息时，会判断设备的鉴权类型和密码摘要算法。
设备消息上报通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:device.message，Event:report）、创建规则动作、修改规则触发条件接口配置并激活规则后，当设备上报消息数据时，物联网平台会向应用服务器推送通知消息。 URI POST
是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id
获取到access_token之后，可以消息/属性上报等功能。其中access_token放于消息头中，下面示例为上报属性： 图3 上报属性 图4 上报属性 https接口介绍 物联网平台的接口如下表所示： 接口分类 用途 接口 设备鉴权相关接口 设备鉴权 /v5/device-auth 设备消息相关接口 设备消息上报
设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI GET /v5/iot/{pr
请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。。
设备消息状态变更通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:device.message.status，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当设备消息状态变更时，物联网平台会向应用服务器推送通知消息。 URI
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
