云服务器内容精选

华为云首页用户手册

设备侧HTTPS接口参考

设备接入 IOTDA-API概览:设备鉴权

设备鉴权 API 说明设备鉴权设备鉴权接口，鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时，都需要携带access_token信息。如果access_token超期，需要重新认证设备获取access_token。如果access_token未超期重复获取access_token，老的access_token在未超期前保留30s，30s之后失效。

设备接入 IOTDA 设备侧HTTPS接口参考
设备接入 IOTDA-使用https协议接入:https接口介绍

https接口介绍物联网平台的接口如下表所示：接口分类用途接口设备鉴权相关接口设备鉴权 /v5/device-auth 设备消息相关接口设备消息上报 /v5/devices/{device_id}/sys/messages/up 设备属性相关接口设备属性上报 /v5/devices/{device_id}/sys/properties/report 网关上报子设备属性 /v5/devices/{device_id}/sys/gateway/sub-devices/properties/report

设备接入 IOTDA 设备侧HTTPS接口参考
设备接入 IOTDA-使用https协议接入:业务流程

业务流程设备接入前，需创建产品（可通过控制台创建或者使用应用侧API创建产品）。产品创建完毕后，需注册设备（可通过控制台注册单个设备或者使用应用侧API注册设备创建）。设备注册完毕后，通过设备鉴权接口获取设备的access_token。点击这里，填写设备ID和设备秘钥，获取时间戳和加密后的password。按照表1 鉴权JSON消息体编辑您的鉴权JSON消息体，编辑后的消息以图2为例。表1 鉴权JSON消息体描述内容 device_id 您的设备ID sign_type 建议为0，表示不会校验消息时间戳与平台时间是否一致，仅判断密码是否正确 timestamp 时间戳，例如2024062602，根据图1 ClientId生成工具中的ClientId获取 password 加密后的password，为图1 ClientId生成工具中的Password 图1 ClientId生成工具图2 获取设备access_token 参考平台对接信息，获取接入地址，按照图2 获取设备access_token拼接成URL后发送，即可获得access_token。获取到access_token之后，可以消息/属性上报等功能。其中access_token放于消息头中，下面示例为上报属性：图3 上报属性图4 上报属性

设备接入 IOTDA 设备侧HTTPS接口参考
设备接入 IOTDA-使用https协议接入:使用限制

使用限制描述限制支持的HTTP协议版本支持 Hypertext Transfer Protocol — HTTP/1.0 协议支持 Hypertext Transfer Protocol — HTTP/1.1 协议支持HTTPS协议物联网平台仅支持HTTPS协议，证书下载请参考证书资源。支持的TLS版本 TLS 1.2 支持的body体最大长度 1MB 接口规格说明请参考产品规格说明。网关上报子设备属性时一次最大可上报子设备数 50

设备接入 IOTDA 设备侧HTTPS接口参考
设备接入 IOTDA-使用https协议接入:HTTPS设备与物联网平台通信

HTTPS设备与物联网平台通信设备使用HTTPS协议接入平台时，平台和设备通过https接口调用通信。通过这些接口，平台和设备可以实现设备鉴权、消息上报及属性上报。消息类型说明设备鉴权用于设备获取鉴权信息access_token。设备属性上报用于设备按产品模型中定义的格式将属性数据上报给平台。设备消息上报用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。网关批量属性上报用于网关设备将多个子设备的属性数据一次性上报给平台。

设备接入 IOTDA 设备侧HTTPS接口参考