Instal dan konfigurasi IoT Platform SDK untuk Python untuk panggil API - IoT Platform

IoT Platform menyediakan SDK untuk Python. Topik ini menjelaskan cara menginstal dan mengonfigurasi IoT Platform SDK untuk Python serta memberikan contoh kode untuk memanggil operasi API dari IoT Platform.

Instal SDK

Instal lingkungan pengembangan Python.
Unduh paket instalasi Python dari situs resmi Python dan instal Python. Versi yang didukung adalah Python 2.7.x dan 3.x.
Instal pip untuk mengelola paket Python. Jika Anda sudah menginstal pip, lewati langkah ini.
Unduh paket instalasi pip dari situs resmi pip dan instal pip.
Jalankan perintah berikut sebagai administrator untuk menginstal IoT Platform SDK untuk Python.
Untuk informasi lebih lanjut tentang IoT Platform SDK untuk Python, kunjungi aliyun-python-sdk-iot.
```
sudo pip install aliyun-python-sdk-core
sudo pip install aliyun-python-sdk-iot
```

Impor file terkait IoT Platform SDK untuk Python ke dalam file Python Anda.

from aliyunsdkcore import client
from aliyunsdkiot.request.v20180120 import RegisterDeviceRequest
from aliyunsdkiot.request.v20180120 import PubRequest
...

Inisialisasi SDK

Contoh berikut menunjukkan cara menginisialisasi SDK jika layanan IoT Platform Anda berada di wilayah Tiongkok (Shanghai):

Panggil metode client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai') untuk memuat informasi inisialisasi SDK.

import os
accessKeyId = os.getenv('ACCESS_KEY_ID')
accessKeySecret = os.getenv('ACCESS_KEY_SECRET')
clt = client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai')

Parameter

Deskripsi

clt

Klien SDK yang telah diinisialisasi. cn-shanghai menunjukkan ID wilayah tempat layanan IoT Platform Anda berada.

Anda dapat melihat wilayah tersebut di pojok kiri atas konsol IoT Platform.

Untuk informasi lebih lanjut tentang ID wilayah, lihat Wilayah yang didukung.

Ajukan permintaan

SDK mengenkapsulasi sebuah kelas untuk setiap operasi API. Nama kelasnya dalam format ${Nama Operasi API}+"Request". Anda dapat membuat instance request dari kelas ini dan menggunakan metode "set_"+${parameter permintaan} untuk menentukan parameter permintaan. Gunakan metode do_action_with_exception(request) dari klien clt untuk mendapatkan respons.

Untuk informasi lebih lanjut tentang operasi API dari IoT Platform, lihat Daftar operasi berdasarkan fungsi. Untuk detail parameter request dan response dari setiap operasi API, lihat dokumentasi API.

Contoh berikut menunjukkan cara memanggil operasi Pub untuk menerbitkan pesan ke topik. Untuk informasi lebih lanjut tentang parameter permintaan, lihat Pub.

request = PubRequest.PubRequest()
request.set_accept_format('json')  # Format dalam mana respons dikembalikan. Secara default, format XML digunakan. Dalam contoh ini, format JSON digunakan.
request.set_IotInstanceId('iotInstanceId') 
request.set_ProductKey('productKey')
request.set_TopicFullName('/productKey/deviceName/get')  # Nama lengkap topik yang digunakan untuk menerbitkan pesan.
request.set_MessageContent('aGVsbG8gd29ybGQ=')  #hello world Base64 String
request.set_Qos(0)
result = clt.do_action_with_exception(request)
print('result : ' + result)

Lampiran: Contoh kode

Anda dapat melihat atau mengunduh contoh kode operasi API di IoT Platform SDK Sample Center. Contoh kode SDK tersedia untuk Java, Python, PHP, .NET, dan Go.

Alibaba Cloud OpenAPI Explorer menyediakan alat debugging online untuk operasi API. Di halaman Debugging API, Anda dapat mencari operasi API, memanggil operasi API, dan menghasilkan contoh kode untuk operasi API dari SDK yang berbeda. Di sisi kanan halaman, Anda dapat melihat contoh kode SDK di tab Contoh Kode. Di tab Hasil Debugging, Anda dapat melihat URL permintaan sebenarnya dan respons dalam format JSON.