检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口说明 MQTT CONNECT连接鉴权 设备请求引导消息 设备接收引导信息 父主题： 设备发放
安全隧道WebSocket接口参考 使用安全隧道通信协议接入 建立安全隧道的WebSocket连接 安全隧道协议消息交互说明
设备侧HTTPS接口参考 使用https协议接入 API概览 设备鉴权 设备消息上报 设备属性上报
设备侧MQTT/MQTTS接口参考 使用前必读 通信方式概述 Topic定义 设备连接鉴权 设备命令 设备消息 设备属性 网关与子设备管理 软固件升级 文件上传/下载管理 设备时间同步 设备信息上报 设备日志收集 远程配置 设备隧道管理
上报属性 https接口介绍 物联网平台的接口如下表所示： 接口分类 用途 接口 设备鉴权相关接口 设备鉴权 /v5/device-auth 设备消息相关接口 设备消息上报 /v5/devices/{device_id}/sys/messages/up 设备属性相关接口 设备属性上报
设备鉴权 接口说明 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取access_token。如
设备消息上报 功能描述 是指设备无法按照产品模型中定义的属性格式进行数据上报时，可调用此接口将设备的自定义数据格式上报给平台，平台对该消息不进行解析，该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别，请查看消息通信说明。 低配置且资源受限或
设备上报升级状态 功能介绍 设备上报升级状态。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 网关设备上报时，子设备进
设备侧LwM2M接口参考 使用LwM2M协议接入 API概览 设备鉴权 设备属性上报 设备命令下发
2.05 Content with {value} 不涉及 设备通过LwM2M协议上报的数据都是二进制报文数据，一般都需要通过编解码插件进行解析，参考编解码插件开发。 请求参数 参数名 参数位置 可选/必选 说明 value Payload 必选 参数说明: 设备上报的数据内容 请求示例
设备连接鉴权 接口说明 IoT平台设备侧支持MQTT协议的connect消息接口，鉴权通过后建立设备与平台间的MQTT连接。 参数说明 设备通过MQTT协议的connect消息进行鉴权，对于构造ClientId的各个部分信息都必须包括进去，平台收到connect消息时，会判断设备的鉴权类型和密码摘要算法。
reported区用于存储设备最新上报的设备属性值，即上报值。当设备上报数据时，平台刷新reported区属性值为设备上报的设备属性值。 设备影子可以通过调用应用侧API接口配置，也可以通过登录控制台，在设备详情->设备影子->属性配置页面配置。（设备影子主要针对设备属性配置，它的配置依赖产品模型）。 设备影
设备属性上报 功能介绍 用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。
消息上报是设备直接将数据传到云端，通过数据流转功能将数据转发到应用侧或华为云其他云服务的一种方式。平台对设备上报的消息不进行解析和存储，不需要建立产品模型便可以使用。 图1 设备消息上报流程 使用场景 平台对设备上报的数据不进行解析和存储，需要通过数据转发规则转发到华为云其他云服务上进行存储和处理的场景。 使用限制 单个消息内容不大于1M。
是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id
API概览 设备鉴权 API 说明 设备鉴权 设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取a
需要调用AT接口或函数接口来实现业务数据的收发，不需要关心LWM2M协议，参考此规范。 设备鉴权 API 说明 设备鉴权 设备向物联网平台注册，物联网平台进行设备的身份认证。物联网平台向设备订阅资源，设备获取到物联网平台下发订阅时的token，调用属性上报等其他接口时，都需要携带token信息。
设备消息 设备消息上报 平台消息下发 父主题： 设备侧MQTT/MQTTS接口参考
远程配置 平台下发配置通知 设备上报配置响应 父主题： 设备侧MQTT/MQTTS接口参考
MQTT CONNECT连接鉴权 接口功能 设备发放平台设备侧支持MQTT协议的connect消息接口，接口规范参考MQTT标准规范，鉴权通过后建立设备与平台间的MQTT连接。 设备发放平台目前只支持MQTTS接入，设备通过connect消息接口和平台建立MQTT连接时，需要使用
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
