O HTTPS é um protocolo de comunicação seguro baseado em HTTP e criptografado com SSL. Configure o Link SDK for C para conectar dispositivos que utilizam o protocolo HTTPS ao IoT Platform.
Pré-requisitos
Processo
O programa aplicativo chama as operações de API do Link SDK for C para se conectar ao IoT Platform via HTTPS.
A figura a seguir ilustra esse processo. Neste exemplo, utiliza-se o programa aplicativo ./demos/http_basic_demo.c.
Para obter mais informações sobre as operações de API específicas para conexão HTTPS, consulte aiot_http_api.h.
Observações de uso
-
Descrição geral:
Para detalhes sobre as regiões suportadas, consulte Uso e limites.
Somente o método de requisição POST é suportado.
-
Dispositivos conectados via HTTPS podem enviar mensagens ao IoT Platform. No entanto, o IoT Platform não consegue enviar comandos aos dispositivos por meio desse protocolo.
Caso os dispositivos precisem receber mensagens do IoT Platform, conecte-os via MQTT. Para mais informações, consulte Visão geral.
-
Autenticação de dispositivo:
O valor de Content-Type no cabeçalho HTTPS da requisição de autenticação do dispositivo deve ser application/json.
Os tokens retornados na autenticação do dispositivo têm validade de apenas sete dias. Após a expiração, obtenha novos tokens.
-
Envio de mensagens:
O valor de Content-Type no cabeçalho HTTPS da requisição de envio de mensagem deve ser application/octet-stream.
O tamanho dos dados enviados por uma operação de API não pode exceder 128 KB.
-
O formato da requisição de envio de mensagem é https://iot-as-http.${regionID}.aliyuncs.com/topic/${topic}.
Variável
Descrição
${regionID}
ID da região onde o dispositivo está conectado ao IoT Platform. Para mais informações, consulte Regiões e zonas.
${topic}
O tópico HTTPS. É possível especifique um tópico MQTT para esta variável. Os padrões de tópicos HTTPS e MQTT são idênticos. Para mais detalhes, consulte O que é um tópico.
Exemplos
Para consultar exemplos práticos, veja Exemplo de uso.
Para verificar os códigos de erro, consulte Códigos de erro comuns.