Bagikan melalui

Mengimpor SOAP API ke API Management dan mengonversinya ke REST

BERLAKU UNTUK: Semua tingkat API Management

Artikel ini menunjukkan cara mengimpor SOAP API sebagai spesifikasi WSDL lalu mengonversinya ke REST API. Ini juga menunjukkan cara menguji API di Azure 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

Buka instans API Management Anda

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

    Cuplikan layar yang memperlihatkan layanan API Management di hasil pencarian.

  2. Pada halaman layanan API Management , pilih instans API Management Anda:

    Cuplikan layar yang menampilkan instans API Management di halaman layanan API Management.

Mengimpor dan menerbitkan API backend

  1. Di panel kiri, di bagian API , pilih API.

  2. Pada halaman API, pilih + Tambahkan API.

  3. Di bawah Buat dari definisi, pilih WSDL:

    Cuplikan layar yang memperlihatkan petak peta WSDL di portal Microsoft Azure.

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

  5. Di bawah 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.

    Cuplikan layar yang memperlihatkan opsi SOAP ke REST.

  6. Kotak Nama tampilan dan Nama diisi secara otomatis dengan informasi dari SOAP API.

    Nama Tampilan, URL, dan Deskripsi secara otomatis dimasukkan untuk operasi. Operasi juga menerima Nama yang dihasilkan sistem.

  7. Masukkan pengaturan API lainnya, lalu pilih Buat. Anda juga dapat mengonfigurasi nilai-nilai ini nanti dengan masuk ke tab Pengaturan .

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

Menguji API baru di portal Microsoft Azure

Anda dapat memanggil operasi langsung dari portal Microsoft Azure. Metode ini 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 kueri dan bidang untuk header. Salah satu headernya adalah Ocp-Apim-Subscription-Key. Header ini adalah 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. Pilih Kirim.

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

Menambahkan API lainnya

Anda dapat menyusun API dari API yang diekspos oleh layanan yang berbeda, termasuk:

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

Catatan

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

Untuk menambahkan API ke API yang ada:

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

    Cuplikan layar yang memperlihatkan halaman layanan API Management.

  2. Pilih API di halaman Gambaran Umum atau pilih API >API di menu di sebelah kiri.

    Cuplikan layar yang memperlihatkan pilihan API di halaman Gambaran Umum.

  3. Pilih elipsis (...) di samping API yang ingin Anda tambahkan API lain.

  4. Pilih Impor dari menu drop-down:

    Cuplikan layar yang memperlihatkan perintah Impor.

  5. Pilih layanan untuk mengimpor API.

Konten terkait