IoT Platform met à disposition un SDK cloud pour Python. Découvrez comment installer, configurer et utiliser ce SDK Python pour appeler les API cloud.
Installer le SDK
-
Installez Python.
Téléchargez Python depuis le site officiel de Python. Le SDK prend en charge les versions Python 2.7.x et 3.x.
-
Installez pip. Ignorez cette étape si pip est déjà installé.
Téléchargez pip depuis le site officiel de pip.
-
Installez le SDK IoT Python avec des droits d'administrateur.
Pour obtenir des instructions sur l'utilisation du SDK, consultez la page aliyun-python-sdk-iot.
sudo pip install aliyun-python-sdk-core sudo pip install aliyun-python-sdk-iot -
Importez les modules du SDK IoT Python.
from aliyunsdkcore import client from aliyunsdkiot.request.v20180120 import RegisterDeviceRequest from aliyunsdkiot.request.v20180120 import PubRequest ...
Initialiser le SDK
Le code suivant illustre l'initialisation du SDK pour appeler une API dans la région Chine (Shanghai).
Initialisez le client SDK à l'aide de client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai') :
import os
accessKeyId = os.getenv('ACCESS_KEY_ID')
accessKeySecret = os.getenv('ACCESS_KEY_SECRET')
clt = client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai')|
Paramètre |
Description |
|
clt |
Initialise le client SDK. Vérifiez la région de votre service dans le coin supérieur gauche de la console IoT Platform. Codes de région : Régions prises en charge. |
Appeler une API
Le SDK encapsule chaque requête API sous forme de classe ${API name}Request. Définissez les paramètres de requête avec set_${request parameter name}, puis appelez do_action_with_exception(request) sur le client SDK clt pour obtenir la réponse.
Pour consulter la liste des API cloud IoT Platform, reportez-vous à la section Liste des API. Pour plus d'informations sur les paramètres de requête dans request et les paramètres de réponse dans response, consultez la référence d'API correspondante.
Cette rubrique utilise l'opération Pub comme exemple pour montrer comment publier un message sur un topic. Pour en savoir plus sur les paramètres de requête, consultez Pub.
request = PubRequest.PubRequest()
request.set_accept_format('json') # Set the data format of the response. The default format is XML. This example sets the format to JSON.
request.set_IotInstanceId('iotInstanceId')
request.set_ProductKey('productKey')
request.set_TopicFullName('/productKey/deviceName/user/get') # The full name of the topic to which the message is sent.
request.set_MessageContent('aGVsbG8gd29ybGQ=') # hello world Base64 string
request.set_Qos(0)
result = clt.do_action_with_exception(request)
print('result : ' + result)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 d'API. Ces exemples couvrent les SDK Java, Python, PHP, .NET et Go.
Le portail des développeurs OpenAPI d'Alibaba Cloud propose un outil de débogage d'API en ligne. Sur la page API debugging, vous pouvez rechercher et tester des appels d'API. Le portail génère automatiquement des exemples de code SDK dans différents langages en fonction des paramètres que vous saisissez. Consultez le code généré dans l'onglet SDK Example et la réponse dans l'onglet Call Result.