更新时间:2024-07-29 GMT+08:00

使用https协议接入

概述

HTTPS是基于HTTP协议,通过SSL加密的一种安全通信协议。物联网平台支持HTTPS协议通信。

使用限制

描述

限制

支持的HTTP协议版本

支持 Hypertext Transfer Protocol — HTTP/1.0 协议

支持 Hypertext Transfer Protocol — HTTP/1.1 协议

支持HTTPS协议

物联网平台仅支持HTTPS协议,证书下载请参考证书资源

支持的TLS版本

TLS 1.2

支持的body体最大长度

1MB

接口规格说明

请参考产品规格说明

网关上报子设备属性时一次最大可上报子设备数

50

调用说明

物联网平台的Endpoint请参见:地区和终端节点

使用“设备接入-> HTTPS(443)”对应的Endpoint,端口为443。

HTTPS设备与物联网平台通信

设备使用HTTPS协议接入平台时,平台和设备通过https接口调用通信。通过这些接口,平台和设备可以实现设备鉴权、消息上报及属性上报。

消息类型

说明

设备鉴权

用于设备获取鉴权信息access_token。

设备属性上报

用于设备按产品模型中定义的格式将属性数据上报给平台。

设备消息上报

用于设备将自定义数据上报给平台,平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。

网关批量属性上报

用于网关设备将多个子设备的属性数据一次性上报给平台。

业务流程

  1. 设备接入前,需创建产品(可通过控制台创建或者使用应用侧API创建产品)。
  2. 产品创建完毕后,需注册设备(可通过控制台注册单个设备或者使用应用侧API注册设备创建)。
  3. 设备注册完毕后,通过设备鉴权接口获取设备的access_token。
    1. 点击这里,填写设备ID和设备密钥,获取时间戳和加密后的password。
    2. 按照表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
    3. 参考平台对接信息,获取接入地址,按照图2 获取设备access_token拼接成URL后发送,即可获得access_token。
  4. 获取到access_token之后,可以进行消息/属性上报等功能。其中access_token放于消息头中,下面示例为上报属性:
    图3 上报属性
    图4 上报属性

http接口介绍

物联网平台的接口如下表所示:

接口分类

用途

接口

设备鉴权相关接口

设备鉴权

/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