Uso del SDK de IoT Platform para Go - IoT Platform - Centro de documentación de Alibaba Cloud

IoT Platform ofrece un SDK para Go. Este tema describe cómo instalar y configurar el SDK de IoT Platform para Go, y proporciona código de ejemplo para usar el SDK en llamadas a operaciones de API de IoT Platform.

Instalación del SDK

Instale Go.

Go 1.6 y versiones posteriores son compatibles. Para obtener un paquete de instalación de Go, visite el sitio web oficial de Go.
Una vez instalado Go, cree una variable de sistema llamada GOPATH y establezca su valor al directorio de su código.

Para obtener más información sobre la variable GOPATH, ejecute el comando go help gopath.
Ejecute el siguiente comando para instalar Alibaba Cloud SDK para Go:
```
go get -u github.com/aliyun/alibaba-cloud-sdk-go/sdk
```
Para más información, visite alibaba-cloud-sdk-go.
Ejecute el siguiente comando para importar los archivos relacionados con el SDK de IoT Platform para Go a un archivo Go:
```
import "github.com/aliyun/alibaba-cloud-sdk-go/services/iot"
```

Inicialización del SDK

package main
import (
    "github.com/aliyun/alibaba-cloud-sdk-go/sdk"
    "os"
)
func main() {
    accessKeyId := os.Getenv("ACCESS_KEY_ID")
    accessKeySecret := os.Getenv("ACCESS_KEY_SECRET")
    client, err := sdk.NewClientWithAccessKey("<your regionId>", accessKeyId, accessKeySecret)
    if err != nil {
        // Handle exceptions
        panic(err)
    }
}

Parámetro	Descripción
regionId	El ID de región de IoT Platform. Por ejemplo, el ID de la región China (Shanghai) es `cn-shanghai`. Para más información, consulte Supported regions.

Realización de una solicitud

Para consultar la lista de API en la nube de IoT Platform, consulte API list. Para consultar las descripciones de los parámetros de solicitud en request y los parámetros de respuesta en response, consulte la referencia de la API correspondiente.

Este tema utiliza la operación Pub como ejemplo para mostrar cómo publicar un mensaje en un topic. Para obtener información sobre los parámetros de solicitud, consulte Pub.

Importante

En el siguiente código, ${iotInstanceId} representa el ID de instancia. Puede encontrar el ID de la instancia actual en la página Instance Overview de la consola de IoT Platform.

Si existe un ID, debe pasar este ID. De lo contrario, la llamada a la API fallará.
Si la página Instance Details o el ID no existen, no es necesario pasar un ID. Puede eliminar el código de solicitud relacionado con IotInstanceId o pasar un valor vacío "". De lo contrario, la llamada a la API fallará.

Para más información sobre instancias, consulte Instance overview. Para obtener detalles sobre cómo adquirir una instancia, consulte Purchase an Enterprise instance. Para preguntas frecuentes, consulte FAQ about IoT Platform instances.

request := iot.CreatePubRequest()
request.AcceptFormat = "json"
request.IotInstanceId = "<your iotInstanceId>"
request.ProductKey = "<your productKey>"
request.TopicFullName = fmt.Sprintf("/%s/%s/user/get", "<your productKey>", "<your deviceName>")
request.MessageContent = base64.StdEncoding.EncodeToString([]byte("hello world"))
request.Qos = "0"
response, err := client.Pub(request)
if err != nil {
    fmt.Print(err.Error())
}
fmt.Printf("response is %#v\n", response)

Apéndice: Código de ejemplo

Puede acceder al Centro de ejemplos del SDK en la nube de IoT Platform para consultar o descargar código de ejemplo para llamadas a la API. El código de ejemplo incluye muestras para los SDK de Java, Python, PHP, .NET y Go.

El Portal para desarrolladores de OpenAPI de Alibaba Cloud proporciona una herramienta de depuración de API en línea. En la página API debugging, puede buscar y probar llamadas a la API. El portal genera automáticamente código de ejemplo del SDK en diferentes lenguajes según los parámetros que introduzca. Consulte el código generado en la pestaña SDK Example y la respuesta en la pestaña Call Result.