Domain Names:Ikhtisar integrasi

Pengenalan OpenAPI

Alibaba Cloud menyediakan OpenAPI Explorer, sebuah platform yang mengintegrasikan pencarian API, dokumentasi, debugging online, pembuatan SDK, contoh kode, diagnostik panggilan, dan statistik. OpenAPI Explorer juga menghasilkan contoh kode SDK untuk membantu Anda memulai dengan cepat. Untuk informasi selengkapnya, lihat Apa itu OpenAPI?.

Versi

Alibaba Cloud OpenAPI menggunakan nomor versi untuk mengelola API di berbagai rilis produk utama. Domain Names saat ini mendukung versi API 2018-01-29. Nilai ini merupakan identifikasi versi, bukan tanggal. Versi ini selalu memberikan akses ke data API publik terbaru, meskipun API tersebut mungkin telah diperbarui sejak 2018-01-29.

Debug secara online

Untuk memanggil API, Anda harus mengetahui versinya, titik akhir (endpoint), gaya, serta metode pemanggilan yang didukung.

Sebagai contoh, untuk menggunakan API SaveSingleTaskForCreatingOrderActivate (mengirimkan tugas pendaftaran domain), pilih API tersebut di panel navigasi kiri OpenAPI Explorer. Di area tengah, pilih titik akhir seperti China (Hangzhou), lalu masukkan parameter permintaan. Parameter tersebut mencakup DomainName (domain yang ingin Anda daftarkan), SubscriptionDuration (periode pembelian), RegistrantProfileId (ID profil domain), EnableDomainProxy (apakah akan mengaktifkan perlindungan privasi domain), dan PermitPremiumActivation (apakah diizinkan mendaftarkan domain premium). Setelah itu, klik Initiate Request. Anda dapat melihat deskripsi API dan dokumentasi parameter permintaan di panel kanan.

Titik masuk debugging

Halaman debugging tersedia di: Halaman debugging API Domain Names.

Titik akhir (Endpoints)

Untuk meminimalkan latensi, pilih titik akhir yang berada di wilayah sumber daya Anda.

Titik akhir untuk Singapura: domain-intl.aliyuncs.com.

Gaya API

Gaya RPC.

Identitas

Secara default, OpenAPI Explorer menggunakan identitas Akun Alibaba Cloud Anda untuk panggilan API. Karena akun ini memiliki akses penuh ke semua API, kami sangat menyarankan agar Anda membuat RAM user untuk akses API dan operasional harian. Berikan izin Domain Names yang diperlukan kepada RAM user tersebut sebelum melakukan panggilan API. Untuk informasi selengkapnya, lihat Buat RAM user untuk menjalankan operasi Domain Names.

Informasi lebih lanjut

• Identitas, kredensial, dan otorisasi

• Pembatasan laju dan manajemen kuota

Metode integrasi

• Alibaba Cloud SDK

  • Alibaba Cloud menyediakan SDK untuk Java, C#, Go, Python, Node.js/TypeScript, PHP, dan C++. SDK tersebut mengenkapsulasi logika signature, penanganan timeout, dan logika retry, serta menyediakan objek Request dan Response untuk menyederhanakan pengembangan. Untuk informasi selengkapnya, lihat Alibaba Cloud SDK.

  • Anda dapat menggunakan Domain Names SDK untuk memanggil OpenAPI. Untuk informasi tentang bahasa yang didukung dan cara menginstal dependensi, lihat Contoh kode SDK untuk Java.

• Alibaba Cloud CLI

  • Alibaba Cloud CLI memungkinkan Anda menjalankan perintah aliyun untuk berinteraksi dengan layanan Alibaba Cloud dan mengelola sumber daya layanan cloud dari terminal Anda. Untuk informasi selengkapnya, lihat Apa itu Alibaba Cloud CLI.

  • Alibaba Cloud CLI saat ini tidak mendukung API Domain Names.

• Terraform

  • Terraform adalah tool open-source untuk mempratinjau, menyediakan, dan mengelola infrastruktur cloud dengan menerjemahkan templat menjadi panggilan API. Untuk informasi selengkapnya, lihat Apa itu Alibaba Cloud Terraform?.

  • Terraform saat ini tidak mendukung API Domain Names.

• Resource Orchestration Service (ROS)

  • Resource Orchestration Service (ROS) mengotomatiskan penyediaan sumber daya cloud melalui templat. Anda mendefinisikan sumber daya yang diperlukan beserta dependensinya dalam sebuah templat, dan ROS secara otomatis membuat serta mengonfigurasinya. Untuk informasi selengkapnya, lihat Apa itu Resource Orchestration Service.

  • ROS saat ini tidak mendukung API Domain Names.

• Panggilan API kustom

  • Untuk melakukan panggilan HTTP native, Anda harus mengimplementasikan algoritma signature, menyusun permintaan kustom, dan memulai panggilan HTTP. Untuk informasi selengkapnya tentang mekanisme signature, lihat Struktur permintaan dan signature V3.

Catatan penggunaan

• Jika panggilan API Domain Names mengembalikan kesalahan, gunakan kode kesalahan tersebut untuk memverifikasi bahwa parameter permintaan dan nilainya sudah benar.

• Anda juga dapat mencatat ID permintaan dari tanggapan atau pesan kesalahan SDK, lalu menggunakan Alibaba Cloud OpenAPI Diagnostic Platform untuk diagnostik self-service.