Impor SOAP API ke API Management dan konversi ke REST

  • Artikel

BERLAKU UNTUK: Semua tingkatAN API Management

Artikel ini menunjukkan cara mengimpor SOAP API sebagai spesifikasi WSDL lalu mengonversinya ke REST API. Artikel ini juga menampilkan cara menguji API di API Management.

Dalam artikel ini, Anda akan mempelajari cara:

  • Mengimpor SOAP API dan mengonversinya ke REST
  • Menguji API di portal Microsoft Azure

Catatan

Impor WSDL ke API Management diatur dalam batasan tertentu. File WSDL dengan arahan wsdl:import, xsd:import, dan xsd:include tidak didukung. Terkait alat sumber terbuka untuk memperbaiki dan menggabungkan dependensi ini dalam file WSDL, lihat repositori GitHub ini.

Prasyarat

Selesaikan panduan mulai cepat berikut: Memulai instans Azure API Management

Membuka instans API Management Anda

  1. Di portal Microsoft Azure, cari dan pilih layanan API Management.

    Pilih layanan API Management

  2. Di halaman layanan API Management, pilih instans API Management Anda.

    Pilih instans API Management Anda

Mengimpor dan menerbitkan API back-end

  1. Dari menu sebelah kiri, di bawah bagian API, pilih API>+ Tambahkan API.

  2. Di bawah Buat dari definisi, pilih WSDL.

    SOAP API

  3. Dalam spesifikasi WSDL, masukkan URL ke SOAP API Anda, atau pilih Pilih file untuk memilih file WSDL lokal.

  4. Dalam Metode impor, pilih SOAP ke REST. Saat opsi ini dipilih, API Management mencoba membuat transformasi otomatis antara XML dan JSON. Dalam hal ini, konsumen harus memanggil API sebagai RESTful API, yang mengembalikan JSON. API Management mengonversi setiap permintaan ke panggilan SOAP.

    SOAP ke REST

  5. Bidang berikut diisi secara otomatis dengan informasi dari API SOAP: Nama tampilan, Nama, Deskripsi. Operasi diisi secara otomatis dengan Nama tampilan, URL, dan Deskripsi, dan menerima Nama yang dihasilkan sistem.

  6. Masukkan pengaturan API lainnya. Anda dapat mengatur nilai selama pembuatan atau mengonfigurasikannya nanti dengan masuk ke tab Pengaturan.

    Untuk informasi selengkapnya tentang pengaturan API, lihat tutorial Mengimpor dan menerbitkan API pertama Anda.

  7. Pilih Buat.

Menguji API baru di portal Microsoft Azure

Operasi dapat dipanggil langsung dari portal Microsoft Azure, yang menyediakan cara mudah untuk melihat dan menguji operasi API.

  1. Memilih API yang Anda buat di langkah sebelumnya.

  2. Pilih tab Uji.

  3. Pilih operasi.

    Halaman ini menampilkan bidang untuk parameter dan bidang kueri untuk header. Salah satu header adalah Ocp-Apim-Subscription-Key, untuk kunci langganan produk yang terkait dengan API ini. Jika Anda membuat instans API Management, Anda sudah menjadi admin, sehingga kunci terisi secara otomatis.

  4. Tekan Kirim.

    Saat pengujian berhasil, backend merespons dengan 200 OK dan beberapa data.

Menambahkan API lainnya

Anda dapat membuat API dari API yang diekspos oleh berbagai layanan, termasuk:

  • Spesifikasi OpenAPI
  • API SOAP
  • A GraphQL API
  • Aplikasi Web yang dihosting di Azure App Service
  • Azure Function App
  • Azure Logic Apps
  • Azure Service Fabric

Tambahkan API yang berbeda ke API yang ada menggunakan langkah-langkah berikut.

Catatan

Saat mengimpor API lain, operasi ditambahkan ke API Anda saat ini.

  1. Buka instans API Management Azure Anda di portal Microsoft Azure.

    Membuka instans Mgmt API Azure

  2. Pilih API pada halaman Ringkasan atau dari menu di sebelah kiri.

    Pilih API

  3. Klik ... di samping API tempat Anda ingin menambahkan API lain.

  4. Pilih Impor dari menu turun.

    Pilih impor

  5. Pilih layanan untuk mengimpor API.

    Pilih layanan

Langkah berikutnya

Mengubah dan memproteksi API yang diterbitkan