SOAP API'sini API Management'a aktarma ve REST'e dönüştürme

  • Makale

UYGULANANLAR: Tüm API Management katmanları

Bu makalede, BIR SOAP API'sini WSDL belirtimi olarak içeri aktarma ve ardından REST API'ye dönüştürme işlemi gösterilmektedir. Makalede AYRıCA API Management'ta API'yi test etme adımları da gösterilmektedir.

Bu makalede şunları öğreneceksiniz:

  • SOAP API'sini içeri aktarma ve REST’e dönüştürme
  • Azure portalında API’yi test etme

Not

API Management'a WSDL içeri aktarma işlemi belirli sınırlamalara tabidir. , xsd:importve xsd:include yönergelerine sahip wsdl:importWSDL dosyaları desteklenmez. Bu bağımlılıkları bir WSDL dosyasında çözümlemek ve birleştirmek için açık kaynak bir araç için bu GitHub deposuna bakın.

Önkoşullar

Şu hızlı başlangıcı tamamlayın: Azure API Management örneği oluşturma

API Management örneğinize gidin

  1. Azure portalında API Management hizmetlerini arayın ve seçin.

    API Management hizmetlerini seçme

  2. API Management hizmetleri sayfasında API Management örneğinizi seçin.

    API Management örneğinizi seçin

Arka uç API’sini içeri aktarma ve yayımlama

  1. Soldaki menüden, API'ler bölümünün altında API'ler>+ API Ekle'yi seçin.

  2. Tanımdan oluştur'un altında WSDL'yi seçin.

    SOAP API’si

  3. WSDL belirtiminde SOAP API'nizin URL'sini girin veya Yerel bir WSDL dosyası seçmek için Dosya seç'i seçin.

  4. İçeri aktarma yöntemi'nde SOAP'den REST'e'yi seçin. Bu seçenek belirlendiğinde, API Management XML ile JSON arasında otomatik dönüştürme yapmaya çalışır. Bu durumda, tüketicilerin API'yi JSON döndüren bir RESTful API olarak çağırması gerekir. API Management her isteği bir SOAP çağrısına dönüştürür.

    SOAP'den REST'ye

  5. Aşağıdaki alanlar SOAP API'sinden alınan bilgilerle otomatik olarak doldurulur: Görünen ad, Ad, Açıklama. İşlemler otomatik olarak Görünen ad, URL ve Açıklama ile doldurulur ve sistem tarafından oluşturulan bir Ad alır.

  6. Diğer API ayarlarını girin. Oluşturma sırasında değerleri ayarlayabilir veya daha sonra Ayarlar sekmesine giderek bunları yapılandırabilirsiniz.

    API ayarları hakkında daha fazla bilgi için bkz . İlk API öğreticinizi içeri aktarma ve yayımlama.

  7. Oluştur'u belirleyin.

Azure portalında yeni API'yi test edin

İşlemler doğrudan bir API’nin işlemlerini görüntülemek ve test etmek için kullanışlı bir yol sağlayan Azure portalından çağrılabilir.

  1. Önceki adımda oluşturduğunuz API’yi seçin.

  2. Test sekmesini seçin.

  3. Bir işlem seçin.

    Sayfada sorgu parametreleri için alanlar ve üst bilgiler için alanlar gösterilir. Bu API ile ilişkilendirilmiş ürünün abonelik anahtarı için, üst bilgilerden biri Ocp-Apim-Subscription-Key üst bilgisidir. API Management örneğini oluşturduysanız zaten bir yöneticisinizdir, bu nedenle anahtar otomatik olarak doldurulur.

  4. Gönder’e basın.

    Test başarılı olduğunda arka uç 200 Tamam ve bazı verilerle yanıt verir.

Diğer API'leri ekleme

Farklı hizmetler tarafından kullanıma sunulan API'lerden oluşan bir API oluşturabilirsiniz, örneğin:

  • OpenAPI belirtimi
  • SOAP API'si
  • GraphQL API'si
  • Azure Uygulaması Hizmetinde barındırılan bir Web Uygulaması
  • Azure İşlev Uygulaması
  • Azure Logic Apps
  • Azure Service Fabric

Aşağıdaki adımları kullanarak mevcut API'nize farklı bir API ekleyin.

Not

Başka bir API'yi içeri aktardığınızda işlemler geçerli API'nize eklenir.

  1. Azure portal'da Azure API Management kurulumunuza gidin.

    Azure API Mgmt örneğine gidin

  2. Genel Bakış sayfasında veya soldaki menüden API'ler'i seçin.

    Özel API'ler

  3. Başka bir API eklemek istediğiniz API'nin yanındaki ... simgesine tıklayın.

  4. Açılan menüden İçeri aktar'ı seçin.

    İçe aktar'ı seçin

  5. API'nin içeri aktarılacağı hizmeti seçin.

    Hizmet seç

Sonraki adımlar

Yayımlanan API’yi dönüştürme ve koruma