SOAP hizmetine proxy ekleme

Bu eğitimde, SOAP tabanlı bir web hizmetinin önüne Edge API proxy'si yerleştirmeyi öğreneceksiniz.

Bu eğiticide, SOAP tabanlı hizmetinizin önünde yeni bir RESTful API'nin nasıl oluşturulacağı gösterilmektedir. Burada ayrıntılı olarak açıklanmamış olsa da SOAP yükünü kabul eden ve arka uç hizmetine ileten bir geçiş proxy'si de oluşturabilirsiniz.

İhtiyacınız olanlar

• Apigee Edge hesabı Henüz hesabınız yoksa Apigee Edge hesabı oluşturma bölümündeki talimatları uygulayarak kaydolabilirsiniz.

Proxy oluşturma

Burada, Edge'in bir SOAP hizmetinin önünde yer alacak proxy'yi oluşturmasını sağlayacaksınız. İki tür SOAP API proxy'si vardır:

• REST-SOAP-REST proxy türü, SOAP'a çeviri katmanı içeren yeni bir RESTful API oluşturur. İstemciler, arka uç hizmeti için gereken sorgu parametrelerini ileterek diğer RESTful hizmetlerinde olduğu gibi bu hizmeti de çağırır. Edge, bunu hizmetin beklediği SOAP yüküne çevirir.
• Geçiş proxy'si proxy türü, istemcilerin yalnızca bir SOAP yükü iletmesine olanak tanır. Bu, SOAP hizmeti çağrılarının Edge yönetim özelliklerinden yararlanmasını sağlamanın bir yoludur.

Proxy'yi test etme

Oluşturduğunuz proxy'yi denemek için bir komut istemi açın ve cURL'ü kullanın. Aşağıdaki komutu yazın:

• ORG, proxy'yi oluşturduğunuz Edge kuruluşunun adıdır.
• ENV, proxy'nin dağıtıldığı ortamdır.
• DOMAIN, kullandığınız Edge örneğine karşılık gelir.

curl "https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

Örneğin, kuruluşunuz docfood, ortamınız test ise ve Edge Enterprise Cloud'u kullanıyorsanız şu gibi bir komut çalıştırırsınız:

curl "https://docfood-test.apigee.net/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

StockSymbol sorgu parametresi için GOOG değerini girdiyseniz Alphabet Inc. Class C hissesinin mevcut fiyatını alırsınız. Örneğin:

{  
   "GetQuoteResponse":{  
      "GetQuoteResult":{  
         "StockSymbol":"GOOG",
         "LastTradeAmount":819.55,
         "LastTradeDateTime":"2017-02-13T14:33:00",
         "StockChange":5.88,
         "OpenAmount":816.0,
         "DayHigh":820.96,
         "DayLow":815.49,
         "StockVolume":785064,
         "PrevCls":813.67,
         "ChangePercent":"+0.72%",
         "FiftyTwoWeekRange":"663.28 - 841.95",
         "EarnPerShare":27.88,
         "PE":29.4,
         "CompanyName":"Alphabet Inc.",
         "QuoteError":false
      }
   }
}

Otomatik olarak oluşturulan OpenAPI spesifikasyonunu alma

"REST to SOAP to REST" kullanarak bir SOAP hizmetine proxy oluşturduğunuzda Edge otomatik olarak bir OpenAPI Spesifikasyonu oluşturur. API için API belgeleri oluşturmak üzere OpenAPI Spesifikasyonu'nu kullanabilirsiniz.

OpenAPI spesifikasyonunu almak için şu URL'yi ziyaret etmeniz yeterlidir:

curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.json

Ek bilgi: Hangi kaynağı, fiili ve sorgu parametrelerini kullanacağınızı nasıl öğrenirsiniz?

Test API çağrısında, arka uç SOAP hizmetine yönelik cURL çağrınızda belirli bir kaynak ve sorgu parametreleri kullandınız. Peki bunu kendi başınıza nasıl öğrenebilirsiniz?

Kaynak ve fiil

Proxy oluştururken API proxy sihirbazında SOAP işlemlerinin API fiilleri ve kaynaklarıyla nasıl eşleneceğini görmüştünüz. Ancak bunları not almadıysanız proxy oluşturulduktan sonra nasıl öğreneceğinizi burada bulabilirsiniz.

API proxy'sinin Geliştir sekmesindeki sol Gezgin bölmesinde, Proxy Uç Noktaları altında akışların listesini görürsünüz. İlgilendiğiniz akışı tıklayın. Örneğin, GetQuote akışı iyi bir seçenektir. Ardından, XML'yi Kod bölmesinde görüntüleyin. Bu bölmede, akışın kaynak yolu ve fiili <Condition> öğesinde gösterilir: /quote ve GET.

Sorgu parametreleri

GetQuote akışı seçiliyken grafik akış görünümündeki ilk politikayı tıklayın. Bu, StockSymbol ve LicenseKey sorgu parametrelerini yakalayan bir Değişkenleri Çıkarma politikası olmalıdır. (SOAP hizmeti için web araması yaparsanız LicenseKey için ne iletmeniz gerektiği belirtilir.)

Yakalanan sorgu parametreleri değişken olarak kaydedilir ve SOAP mesajını oluşturmak için sonraki politika tarafından kullanılır.