检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 设备鉴权 API 说明 设备鉴权 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取a
如何调用API 构造请求 认证鉴权 返回结果 父主题： 应用侧API参考
API使用指导 为了降低应用侧的开发难度、提升应用侧开发效率，物联网平台向应用侧开放了API（Application Programming Interface）。您可以调用开放的API，快速集成物联网平台的功能，如产品管理、设备管理、订阅管理、设备命令、规则管理等功能。 应用侧
备厂商定义并使用LwM2M对象的复杂度，华为定义了19对象，由芯片或模组实现，设备只需要调用AT接口或函数接口来实现业务数据的收发，不需要关心LWM2M协议，参考此规范。 设备鉴权 API 说明 设备鉴权 设备向物联网平台注册，物联网平台进行设备的身份认证。物联网平台向设备订阅资
API 产品管理 设备管理 设备消息 设备命令 设备属性 AMQP队列管理 接入凭证管理 数据流转规则管理 流转数据 设备联动规则 设备影子 设备组管理 标签管理 实例管理 资源空间管理 批量任务 设备CA证书管理 OTA升级包管理 广播消息 设备隧道管理 数据流转积压策略管理 数据流转流控策略管理
查询指定设备加入的设备组列表 应用服务器调用该接口查询设备加入的设备组列表。 设备消息 API 说明 查询设备消息 查询指定设备下的消息，平台为每个设备默认最多保存20条消息，超过20条后， 后续的消息会替换下发最早的消息。 下发设备消息 向设备下发消息，应用服务器可调用此接口向指定设备
应用侧API参考 使用前必读 如何调用API API概览 API 权限与授权项 应用示例 附录
开放协议接入 LwM2M/CoAP协议接入 HTTPS协议接入 MQTT(S)协议接入 父主题： 设备接入
建立安全隧道的WebSocket连接 应用端 设备端 父主题： 安全隧道WebSocket接口参考
上报属性 https接口介绍 物联网平台的接口如下表所示： 接口分类 用途 接口 设备鉴权相关接口 设备鉴权 /v5/device-auth 设备消息相关接口 设备消息上报 /v5/devices/{device_id}/sys/messages/up 设备属性相关接口 设备属性上报
长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。 请求示例 POST wss://{endpoint}/v5/iot/tunnels/{tunnel_id}/source-connect 响应示例 Status Code: 200 接入成功 父主题： 建立安全隧道的WebSocket连接
长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。 请求示例 POST wss://{endpoint}/v5/iot/tunnels/{tunnel_id}/device-connect 响应示例 Status Code: 200 接入成功 父主题： 建立安全隧道的WebSocket连接
查询指定消息id的消息 功能介绍 应用服务器可调用此接口查询平台下发给设备的指定消息id的消息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/messages/{message_id} 表1 路径参数
批量任务的文件管理 上传批量任务文件 查询批量任务文件列表 删除批量任务文件 父主题： 批量任务
e/request_id={request_id} {request_id}用于唯一标识这次请求。设备侧发起的消息带该参数时，需要保证设备侧该参数值的唯一性，可以用递增的数字或者UUID来实现。 设备侧上行请求参数中携带唯一标识，该唯一标识会在下行topic中request_id携带给设备以标记唯一请求链。
服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使
数字、下划线（_）、连接符（-）的组合。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-
管理设备组中的设备 功能介绍 应用服务器可调用此接口管理设备组中的设备。单个设备组内最多添加20,000个设备，一个设备最多可以被添加到10个设备组中。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-group/{group_id}/action
设备鉴权 接口说明 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取access_token。如
服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
