概述

功能原理

应用程序通过调用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接入功能相关错误码，请参见常见错误码。