Instal dan konfigurasi IoT Platform SDK untuk Go agar dapat memanggil operasi API - IoT Platform

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

Instal SDK

Instal Go.
Go versi 1.6 ke atas didukung. Untuk mendapatkan paket instalasi Go, kunjungi situs resmi Go.
Setelah Go terinstal, buat variabel sistem bernama GOPATH dan atur nilainya ke direktori kode Anda.
Untuk informasi lebih lanjut tentang variabel GOPATH, jalankan perintah go help gopath.
Jalankan perintah berikut untuk menginstal Alibaba Cloud SDK untuk Go:
```
go get -u github.com/aliyun/alibaba-cloud-sdk-go/sdk
```
Untuk informasi lebih lanjut, kunjungi alibaba-cloud-sdk-go.
Jalankan perintah berikut untuk mengimpor file yang terkait dengan IoT Platform SDK untuk Go ke dalam file Go:
```
import "github.com/aliyun/alibaba-cloud-sdk-go/services/iot"
```

Inisialisasi 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 {
        // Tangani pengecualian
        panic(err)
    }
}

Parameter	Deskripsi
regionId	ID wilayah dari IoT Platform. Sebagai contoh, ID wilayah China (Shanghai) adalah `cn-shanghai`. Untuk informasi lebih lanjut, lihat Wilayah yang didukung.

Ajukan permintaan

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.

Berikut adalah contoh cara memanggil operasi Pub untuk menerbitkan pesan ke topik. Untuk detail parameter permintaan, lihat Pub.

Penting

Dalam kode sampel berikut, ${iotInstanceId} menentukan ID suatu instance. Anda dapat melihat ID instance tersebut di halaman Overview pada konsol IoT Platform.

Jika instance Anda memiliki ID, Anda harus menentukan ID untuk parameter ini. Jika tidak, permintaan akan gagal.
Jika tidak ada halaman Overview atau ID yang dihasilkan untuk instance Anda, Anda tidak perlu menentukan parameter ini. Anda harus menghapus kode permintaan yang terkait dengan parameter IotInstanceId atau menentukan string kosong ("") untuk parameter tersebut. Jika tidak, permintaan akan gagal.

Untuk informasi lebih lanjut tentang instance IoT Platform, lihat Ikhtisar. Untuk informasi lebih lanjut tentang cara membeli instance, lihat Beli Instance Edisi Perusahaan. Untuk informasi lebih lanjut tentang pertanyaan yang sering diajukan, lihat FAQ tentang Instance 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)

Lampiran: Kode sampel

Anda dapat melihat atau mengunduh kode sampel operasi API di IoT Platform SDK Sample Center. Kode sampel SDK untuk Java, Python, PHP, .NET, dan Go disediakan.

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