功能原理

應用程序通過調用C Link SDK的API，基于HTTPS的協議，與物聯網平臺建立的連接。

如下功能時序圖，以設備的應用程序./demos/http_basic_demo.c為例，介紹應用程序實現該功能的流程。

HTTPS接入API的更多信息，請參見aiot_http_api.h。

使用說明

• 通用說明：

  • HTTPS協議接入的地域限制，請參見使用與限制。

  • HTTPS協議接入僅支持POST請求方法。

  • 通過HTTPS協議接入的設備，可以向物聯網平臺上報消息，但HTTPS協議接入的設備無法接收物聯網平臺下發的指令消息。

    如果您希望設備能被動接收物聯網平臺的消息，可以使用MQTT協議接入設備。更多信息，請參見概述。

• 設備認證：

  • 設備認證請求HTTPS Header中的Content-Type必須為application/json。

  • 設備認證返回的Token僅7天內有效，Token失效后，需重新獲取。

• 發送消息：

  • 發送消息的請求HTTPS Header中的Content-Type必須為application/octet-stream。

  • 發送消息API的傳輸數據大小不超過128 KB。

  • 發送消息的請求格式為https://iot-as-http.${regionID}.aliyuncs.com/topic/${topic}。

    變量	說明
    ${regionID}	設備接入的地域ID。更多信息，請參見地域和可用區。
    ${topic}	該變量的值可以復用MQTT Topic的值。HTTPS Topic規范與MQTT Topic一致。更多信息，請參見什么是Topic。

使用示例

• HTTPS接入功能的參考示例，請參見使用示例。

• HTTPS接入功能相關錯誤碼，請參見常見錯誤碼。