Aracılığıyla paylaş

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

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. Ayrıca Azure API Management'ta API'nin nasıl test yapılacağını da gösterir.

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. , wsdl:importve xsd:import yönergelerine sahip xsd:includeWSDL 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

API Management örneğinize gidin

  1. Azureportalında API Management hizmetleriniarayıp seçin:

    Arama sonuçlarında API Management hizmetlerini gösteren ekran görüntüsü.

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

    API Yönetimi hizmetleri sayfasında bir API Yönetimi örneğini gösteren ekran görüntüsü.

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

  1. Sol bölmedeki API'ler bölümünde API'ler'i seçin.

  2. API'ler sayfasında + API Ekle'yi seçin.

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

    Azure portalındaki WSDL kutucuğunu gösteren ekran görüntüsü.

  4. WSDL belirtiminde SOAP API'nizin URL'sini girin veya Yerel bir WSDL dosyası seçmek için Dosya seç'e tıklayın.

  5. İçeri aktarma yöntemi'nin altında 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 to REST seçeneğini gösteren ekran görüntüsü.

  6. Görünen ad ve Ad kutuları, SOAP API'sinden gelen bilgilerle otomatik olarak doldurulur.

    İşlemler için görünen ad, URL ve Açıklama bilgileri otomatik olarak girilir. İşlemler ayrıca sistem tarafından oluşturulan bir Ad alır.

  7. Diğer API ayarlarını girin ve oluştur'u seçin. Bu değerleri daha sonra Ayarlar sekmesine giderek de yapılandırabilirsiniz.

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

Azure portalında yeni API'yi test edin

İşlemleri doğrudan Azure portalından çağırabilirsiniz. Bu yöntem, API'nin işlemlerini görüntülemek ve test etmek için kullanışlı bir yol sağlar.

  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. Üst bilgilerden biri Ocp-Apim-Subscription-Key'dir. Bu üst bilgi, bu API ile ilişkili ürünün abonelik anahtarına yöneliktir. API Management örneğini oluşturduysanız zaten bir yöneticisinizdir, bu nedenle anahtar otomatik olarak doldurulur.

  4. Gönder'i seçin.

    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'ler dışında bir API oluşturabilirsiniz, örneğin:

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

Not

Bir API'yi içeri aktardığınızda, işlemler geçerli API'nize eklenir.

Api'yi var olan bir API'ye eklemek için:

  1. Azure portalında Azure API Management örneğine gidin:

    API Management hizmetleri sayfasını gösteren ekran görüntüsü.

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

    Genel Bakış sayfasındaki API'lerin seçimini gösteren ekran görüntüsü.

  3. Eklemek istediğiniz başka bir API'nin yanındaki üç noktayı (...) seçin.

  4. Açılır menüden İçeri Aktar seçeneğini seçin.

    İçeri Aktar komutunu gösteren ekran görüntüsü.

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

İlgili içerik