# 使用https协议接入
#### 概述
HTTPS是基于HTTP协议，通过SSL加密的一种安全通信协议。物联网平台支持HTTPS协议通信。
#### 使用限制
| 描述                    | 限制                                                                                                                                           |
|:---|:---|
| 支持的HTTP协议版本           | 支持 Hypertext Transfer Protocol --- HTTP/1.0 协议 支持 Hypertext Transfer Protocol --- HTTP/1.1 协议 |
| 支持HTTPS协议             | 物联网平台仅支持HTTPS协议。证书下载请参考[证书资源](https://support.huaweicloud.com/devg-iothub/iot_02_1004.html#section3)。                                        |
| 支持的TLS版本              | TLS 1.2                                                                                                                                      |
| 支持的body体最大长度          | 1MB                                                                                                                                          |
| 接口规格说明                | 请参考[产品规格说明](https://support.huaweicloud.com/productdesc-iothub/iot_04_0014.html)。                                                            |
| 网关上报子设备属性时一次最大可上报子设备数 | 50                                                                                                                                           |
   
#### 调用说明
物联网平台的Endpoint请参见：[如何获取平台接入地址](https://support.huaweicloud.com/iothub_faq/iot_faq_00123.html)。
![](https://support.huaweicloud.com/api-iothub/public_sys-resources/note_3.0-zh-cn.png)
使用"设备接入-\> HTTPS(443)"对应的Endpoint，端口为443。
#### HTTPS设备与物联网平台通信
设备使用HTTPS协议接入平台时，平台和设备通过https接口调用通信。通过这些接口，平台和设备可以实现设备鉴权、消息上报及属性上报。
| 消息类型     | 说明                                                   |
|:---|:---|
| 设备鉴权     | 用于设备获取鉴权信息access_token。                              |
| 设备属性上报   | 用于设备按产品模型中定义的格式将属性数据上报给平台。                           |
| 设备消息上报   | 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 |
| 网关批量属性上报 | 用于网关设备将多个子设备的属性数据一次性上报给平台。                           |
   
#### 业务流程
1. 设备接入前，需创建产品（可通过控制台创建或者使用应用侧API[创建产品 - CreateProduct](https://support.huaweicloud.com/api-iothub/iot_06_v5_0050.html)）。
2. 产品创建完毕后，需注册设备（可通过控制台[注册单个设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0031.html)或者使用应用侧API[创建设备 - AddDevice](https://support.huaweicloud.com/api-iothub/iot_06_v5_0046.html)创建）。
3. 设备注册完毕后，通过设备鉴权接口获取设备的access_token。
   1. 单击[参数生成工具](https://iot-tool.obs-website.cn-north-4.myhuaweicloud.com/)，填写设备ID和设备密钥，获取时间戳和加密后的password。
   
   2. 按照[表1]编辑您的鉴权JSON消息体，编辑后的消息以[图2]为例。
       表1鉴权JSON消息体 
      | 描述        | 内容                                                                                   |
      |:---|:---|
      | device_id | 您的设备ID                                                                               |
      | sign_type | 建议为0，表示不会校验消息时间戳与平台时间是否一致，仅判断密码是否正确                                                  |
      | timestamp | 时间戳，例如2024062602，根据[图1]中的ClientId获取 |
      | password  | 加密后的password，为[图1]中的Password        |
         
      图1ClientId生成工具   
      ![](https://support.huaweicloud.com/api-iothub/figure/zh-cn_image_0000002607967977.png "点击放大")
      图2获取设备access_token   
      ![](https://support.huaweicloud.com/api-iothub/figure/zh-cn_image_0000001934717036.png "点击放大") 
   
   3. 参考[如何获取平台接入地址](https://support.huaweicloud.com/iothub_faq/iot_faq_00123.html)，获取接入地址，按照[图2]拼接成URL后发送，即可获得access_token。
    
4. 获取到access_token之后，可以进行消息/属性上报等功能。其中access_token放于消息头中，下面示例为上报属性：
   图3上报属性   
   ![](https://support.huaweicloud.com/api-iothub/figure/zh-cn_image_0000001426218584.png "点击放大")
   图4上报属性   
   ![](https://support.huaweicloud.com/api-iothub/figure/zh-cn_image_0000001476295441.png "点击放大") 
 
#### https接口介绍
物联网平台的接口如下表所示：
| 接口分类     | 用途                                                                          | 接口                                                                |
|:---|:---|:---|
| 设备鉴权相关接口 | [设备鉴权](https://support.huaweicloud.com/api-iothub/iot_06_v5_7008.html)      | /v5/device-auth                                                   |
| 设备消息相关接口 | [设备消息上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_7009.html)    | /v5/devices/{device_id}/sys/messages/up                           |
| 设备属性相关接口 | [设备属性上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_7010.html)    | /v5/devices/{device_id}/sys/properties/report                     |
| 设备属性相关接口 | [网关上报子设备属性](https://support.huaweicloud.com/api-iothub/iot_06_v5_7011.html) | /v5/devices/{device_id}/sys/gateway/sub-devices/properties/report |