Utiliser le SDK IoT Platform pour Go - IoT Platform - Centre de documentation Alibaba Cloud

IoT Platform met à disposition un SDK pour Go. Cette rubrique explique comment installer et configurer le SDK IoT Platform pour Go. Elle fournit également des exemples de code illustrant l'utilisation du SDK pour appeler les opérations API d'IoT Platform.

Installer le SDK

Installez Go.

Les versions Go 1.6 et ultérieures sont prises en charge. Pour obtenir le package d'installation de Go, consultez le site web officiel de Go.
Une fois Go installé, créez une variable système nommée GOPATH et définissez sa valeur sur votre répertoire de code.

Pour en savoir plus sur la variable GOPATH, exécutez la commande go help gopath.
Exécutez la commande suivante pour installer le SDK Alibaba Cloud pour Go :
```
go get -u github.com/aliyun/alibaba-cloud-sdk-go/sdk
```
Pour plus d'informations, consultez alibaba-cloud-sdk-go.
Exécutez la commande suivante pour importer les fichiers liés au SDK IoT Platform pour Go dans un fichier Go :
```
import "github.com/aliyun/alibaba-cloud-sdk-go/services/iot"
```

Initialiser le 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)
    }
}

Parameter

Description

regionId

L'ID de région d'IoT Platform. Par exemple, l'ID de la région Chine (Shanghai) est cn-shanghai. Pour plus d'informations, consultez la page Régions prises en charge.

Envoyer une requête

Pour obtenir la liste des API cloud d'IoT Platform, consultez la page Liste des API. Pour connaître la description des paramètres de requête dans request et des paramètres de réponse dans response, reportez-vous à la référence API correspondante.

Cette rubrique utilise l'opération Pub comme exemple pour montrer comment publier un message sur un topic. Pour plus d'informations sur les paramètres de requête, consultez la page Pub.

Important

Dans le code suivant, ${iotInstanceId} représente l'ID d'instance. Vous pouvez trouver l'IDID de l'instance actuelle sur la page Instance Overview de la console IoT Platform.

Si un ID existe, vous devez le transmettre. Sinon, l'appel API échouera.
Si la page Instance Details ou l'ID n'existe pas, vous n'avez pas besoin de transmettre d'ID. Vous pouvez supprimer le code de requête lié à IotInstanceId ou transmettre une valeur vide "". Sinon, l'appel API échouera.

Pour plus d'informations sur les instances, consultez la page Présentation des instances. Pour savoir comment acheter une instance, consultez la page Acheter une instance Enterprise. Pour les questions fréquentes, consultez la page FAQ sur les instances IoT Platform.

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)

Annexe : Exemple de code

Vous pouvez accéder au Centre d'exemples de SDK Cloud IoT Platform pour afficher ou télécharger des exemples de code pour les appels API. Les exemples de code fournissent des illustrations pour les SDK Java, Python, PHP, .NET et Go.

Le portail des développeurs OpenAPI d'Alibaba Cloud propose un outil de débogage API en ligne. Sur la page API debugging, vous pouvez rechercher et tester des appels API. Le portail génère automatiquement des exemples de code SDK dans différents langages en fonction des paramètres que vous saisissez. Affichez le code généré dans l'onglet SDK Example et la réponse dans l'onglet Call Result.