Latihan - Membuat API backend

15 menit

Dalam latihan ini Anda mempelajari cara melakukan tindakan berikut:

Membuat instans API Management (APIM)
Mengimpor API
Mengonfigurasi pengaturan backend
Menguji API

Prasyarat

Akun Azure dengan langganan aktif. Jika Anda belum memilikinya, Anda dapat mendaftar uji coba gratis di https://azure.com/free .

Masuk ke portal Azure dan buka Cloud Shell.
Setelah shell terbuka, pastikan untuk memilih lingkungan Bash .

Membuat instans API Management

Mari kita atur beberapa variabel untuk perintah CLI yang akan digunakan untuk mengurangi jumlah pengetikan ulang. Ganti <myLocation> dengan wilayah yang masuk akal untuk Anda. Nama APIM harus menjadi nama yang unik secara global, dan skrip berikut menghasilkan string acak. Ganti <myEmail> dengan alamat email yang bisa Anda akses.
```
myApiName=az204-apim-$RANDOM
myLocation=<myLocation>
myEmail=<myEmail>
```
Buat grup sumber daya. Perintah berikut membuat grup sumber daya bernama az204-apim-rg.
```
az group create --name az204-apim-rg --location $myLocation
```
Buat instans APIM. Perintah az apim create digunakan untuk membuat instans. Opsi --sku-name Consumption ini digunakan untuk mempercepat proses untuk panduan.
```
az apim create -n $myApiName \
    --location $myLocation \
    --publisher-email $myEmail  \
    --resource-group az204-apim-rg \
    --publisher-name AZ204-APIM-Exercise \
    --sku-name Consumption 
```
Catatan

Operasi ini harus selesai dalam waktu sekitar lima menit.

Mengimpor API backend

Bagian ini menunjukkan cara mengimpor dan menerbitkan API backend spesifikasi OpenAPI.

Di portal Azure, cari dan pilih Layanan API Management.
Pada layar API Management, pilih instans API Management yang Anda buat.
Di panel navigasi layanan manajemen API, di bawah API, pilih API.

Pilih OpenAPI dari daftar dan pilih Penuh di pop-up.

Kotak dialog OpenAPI. Bidang dirinci dalam tabel berikut ini.

Gunakan nilai dari tabel berikut untuk mengisi formulir. Anda dapat membiarkan kolom yang tidak disebutkan nilai defaultnya.

Pengaturan	Nilai	Deskripsi
Spesifikasi OpenAPI	`https://bigconference.azurewebsites.net/`	Mereferensikan layanan yang menerapkan API, permintaan diteruskan ke alamat ini. Sebagian besar informasi yang diperlukan dalam formulir secara otomatis diisi setelah Anda memasukkan ini.
Nama tampilan	Big Conference API	Nama ini akan ditampilkan di portal Pengembang.
Nama	big-conference-api	Memberikan nama unik untuk API.
Keterangan	Diisi otomatis	Berikan deskripsi opsional tentang API.

Pilih Buat.

Mengonfigurasi pengaturan API

BIG Conference API dibuat. Konfigurasikan pengaturan API.

Pilih Pengaturan di bilah di sebelah kanan.
Konfirmasikan bahwa https://bigconference.azurewebsites.net/ berada di bidang URL layanan Web.
Batalkan pilihan kotak centang Langganan yang diperlukan.
Pilih Simpan.

Menguji API

Sekarang setelah API diimpor dan dikonfigurasi, saatnya untuk menguji API.

Pilih Uji.
Pilih Speakers_Get. Halaman memperlihatkan Parameter kueri dan Header, jika ada.
Pilih Kirim.

Backend merespons dengan 200 OK dan beberapa data.

Membersihkan sumber daya Azure

Setelah selesai dengan sumber daya yang Anda buat dalam latihan ini, Anda dapat menggunakan perintah berikut untuk menghapus grup sumber daya dan semua sumber daya terkait.

az group delete --name az204-apim-rg