检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备接收引导信息 接口功能 设备接收发放服务下发的引导信息。 Topic 表1 下发Topic说明 Topic $oc/devices/{device_id}/sys/bootstrap/down 消息发送方 设备发放平台 消息接收方 设备 参数说明 表2 下发参数说明 参数 必选/可选
需要调用AT接口或函数接口来实现业务数据的收发,不需要关心LWM2M协议,参考此规范。 设备鉴权 API 说明 设备鉴权 设备向物联网平台注册,物联网平台进行设备的身份认证。物联网平台向设备订阅资源,设备获取到物联网平台下发订阅时的token,调用属性上报等其他接口时,都需要携带token信息。
设备连接鉴权 接口说明 IoT平台设备侧支持MQTT协议的connect消息接口,鉴权通过后建立设备与平台间的MQTT连接。 参数说明 设备通过MQTT协议的connect消息进行鉴权,对于构造ClientId的各个部分信息都必须包括进去,平台收到connect消息时,会判断设备的鉴权类型和密码摘要算法。
subscribed: topic 响应命令下发 在command_sample.py文件中提供了响应平台下发命令的功能。详细接口信息请参考命令下发接口。 1 2 3 4 5 # 响应平台下发的命令 def command_callback(request_id, command):
平台设置设备属性 功能介绍 用于平台设置设备属性。设备的产品模型中定义了平台可向设备设置的属性,平台可调用此修改设备属性接口设置指定设备的属性数据。设备收到属性设置请求后,需要将执行结果返回给平台,如果设备没回响应平台会认为属性设置请求执行超时。 低配置且资源受限或者对网络流量有
平台查询设备属性 功能介绍 用于平台向设备查询属性信息。平台可调用查询设备属性接口查询设备的属性数据。设备收到属性查询请求后,需要将设备的属性数据返回给平台,如果设备没回响应平台会认为属性查询请求执行超时。 低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与
网关更新子设备状态响应 网关新增子设备请求 网关新增子设备请求响应 网关删除子设备请求 网关删除子设备请求响应 父主题: 设备侧MQTT/MQTTS接口参考
线(_)、连接符(-)的组合。 该接口支持设备将自定义数据通过请求中的body体上报给平台,平台收到该请求后会将body内容转发给应用服务器或华为云其他云服务上进行存储和处理。平台对body中的内容无具体格式限制,小于1MB的数据可以通过该接口携带。 请求示例 POST http
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系,请查看网关与子设备。 属性上报和消息上报的区别,请查看消息通信说明。 网关批量设备属性上报,单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个,建议分不同批次进行上报。
设备时间同步响应 功能描述 平台向设备发送时间同步响应,携带设备发送时间device_send_time。当平台收到时间server_recv_time 后,向设备发送时间server_send_time 。 例如,设备收到的设备侧时间为device_recv_time ,则设备计算自己的准确时间为:
MQTT CONNECT连接鉴权 接口功能 设备发放平台设备侧支持MQTT协议的connect消息接口,接口规范参考MQTT标准规范,鉴权通过后建立设备与平台间的MQTT连接。 设备发放平台目前只支持MQTTS接入,设备通过connect消息接口和平台建立MQTT连接时,需要使用
"Uri-Query":["ep=test"]} Register响应示例 ACK-2.01 MID=25995, Token=514078a73366, OptionSet={"Location-Path":["rd","test"]}, no payload: Observe请求示例
cation/octet-stream"}, c4 0d 5a 6e 96 0b c3 0e 2b 30 37 父主题: 设备侧LwM2M接口参考
OptionSet={"Content-Format":"application/octet-stream"}, no payload 父主题: 设备侧LwM2M接口参考
设备上报日志内容 Topic 上行: $oc/devices/{device_id}/sys/events/up 接口功能 日志收集开关开启时设备使用该接口向平台上报日志内容,最大不超过1MB。 参数说明 字段名 必选/可选 类型 参数描述 services 可选 List<ServiceEvent>
Websocket传输数据,单次大小限制为10k。 只有设备在线时才支持创建隧道。 只有隧道关闭时才支持删除隧道。 父主题: 安全隧道WebSocket接口参考
建立安全隧道的WebSocket连接 应用端 设备端 父主题: 安全隧道WebSocket接口参考
设备认证类型 选择“密钥”。 密钥 设备密钥,可自定义,不填写物联网平台会自动生成。 配置设备影子 用户可以选择在应用侧调用配置设备影子预期数据接口设置设备影子,也可以在设备接入控制台设置设备影子。此处以在设备接入控制台设置设备影子为例。 登录控制台,选择左侧导航栏的“设备”,单击步骤
上报属性 https接口介绍 物联网平台的接口如下表所示: 接口分类 用途 接口 设备鉴权相关接口 设备鉴权 /v5/device-auth 设备消息相关接口 设备消息上报 /v5/devices/{device_id}/sys/messages/up 设备属性相关接口 设备属性上报
设备属性上报 接口说明 用于设备按产品模型中定义的格式将属性数据上报给平台。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/properties/report 传输协议 HTTPS 请求参数 名称 必选 类型 位置 说明 access_token