Azure Logic Apps'teki iş akışlarından kendi web API'lerinizi ve REST API'lerinizi çağırma

Şunlar için geçerlidir: Azure Logic Apps (Tüketim + Standart)

Azure Logic Apps'teki iş akışlarından çağırmak istediğiniz mevcut web API'leriniz veya REST API'leriniz varsa, bu API'leri çağırmadan önce bazı kurulum adımlarını tamamlamanız gerekir. Öncelikle API'lerinizi web uygulamaları veya API uygulamaları olarak dağıtmanız gerekir. Api'lerinizi yüksek oranda ölçeklenebilir ve kolay API barındırma sağlayan bir bulut platformu olan Azure App Service'te barındırarak bu görevi gerçekleştirebilirsiniz.

App Service'te API'lerinizi web uygulamaları olarak dağıtabilirsiniz, ancak api'lerinizi API uygulamaları olarak dağıtmayı düşünebilirsiniz. Bu yaklaşım, bulutta ve şirket içi ortamlarda API'ler oluştururken, barındırırken ve kullanırken işinizi kolaylaştırır. API uygulamasına dağıtmak için API'lerinizdeki herhangi bir kodu değiştirmeniz gerekmez.

bir iş akışından herhangi bir API'yi çağırabilirsiniz, ancak en iyi deneyimi elde etmek için web uygulamanıza veya API uygulamanıza Swagger meta verileri ekleyin. Bu Swagger belgesi, mantıksal uygulama iş akışlarının API'nizle daha iyi ve daha kolay çalışmasına yardımcı olan API işlemlerinizi ve parametrelerinizi açıklar. ayrıca iş akışınızın API'nize erişebilmesi için web uygulamanızda veya API uygulamanızda Çıkış Noktaları Arası Kaynak Paylaşımı (CORS) ayarlamanız gerekir.

Bu kılavuzda Swagger belgesi ekleme, web uygulamanız veya API uygulamanız için CORS'yi ayarlama ve API'nizin App Service'te dağıtımını ve barındırmasını tamamladıktan sonra API'nizi bir iş akışından çağırmaya yönelik seçeneklerin nasıl sağlanacağı gösterilmektedir.

Daha fazla bilgi için bakınız:

• Azure App Service
• ASP.NET web uygulaması oluşturma ve dağıtma
• Azure App Service'te CORS ile RESTful API barındırma

Önkoşullar

• Aktif bir aboneliğe sahip bir Azure hesabı. Aboneliğiniz yoksa ücretsiz bir hesap oluşturun.

• Azure Logic Apps'teki iş akışlarıyla uyumlu desenlerden birini izleyen ve App Service'e bir web uygulaması veya API uygulaması olarak dağıtılan bir web API'si veya REST API.

  Daha fazla bilgi için bakınız:

  • ASP.NET web uygulaması oluşturma ve dağıtma
  • Azure App Service'te CORS ile RESTful API barındırma oluştur

Web uygulamanıza veya API uygulamanıza Swagger ve CORS erişimi ekleme

Web uygulamanıza veya API uygulamanıza bir Swagger belgesi eklediğinizde, Azure Logic Apps'teki iş akışı tasarımcısı API'nizdeki kullanılabilir işlemleri ve parametreleri daha kolay bulabilir ve gösterebilir. ayrıca iş akışınızın API'nize erişebilmesi için web uygulamanızda veya API uygulamanızda Çıkış Noktaları Arası Kaynak Paylaşımı (CORS) ayarlamanız gerekir.

Swagger belgenizi tasarımcıdaki iş akışınızdan okunabilir hale getirmek için, web uygulamanızda veya API uygulamanızda API tanımı özelliklerini ve CORS erişimini ayarlayın.

1. Azure portalında web uygulamanızı veya API uygulama kaynağınızı bulun ve açın.

2. Uygulama kaynağı kenar çubuğunda Genel Bakış'ı seçin.

3. Özellikler sekmesindeki Etki Alanları'nın altında, Varsayılan etki alanı özelliğinden web sitesi adını kopyalayın ve sonraki adım için bir yere kaydedin.

4. Uygulama kaynağı kenar çubuğundaki API'nin altında API tanımı'nı seçin. API tanımı konumu için Swagger JSON dosyanızın URL'sini girin. Bu url genellikle aşağıdaki biçimi kullanır, ancak Swagger dosyanız daha yeni bir API belirtimi kullanıyorsa farklılık gösterebilir:

   https://<website-name>/swagger/docs/v1

   Aşağıdaki örnekte, daha yeni API belirtimine sahip bir Swagger URL'si gösterilmektedir:

   

5. Bitirdiğinizde, Kaydet'i seçin.

6. Uygulama kaynağı kenar çubuğundaki API'nin altında CORS'yi seçin.

7. İzin Verilen Kaynak için CORS ilkesini '*' olarak ayarlayın; bu da tümüne izin vermek anlamına gelir.

   Bu ayar, Azure Logic Apps'teki iş akışı tasarımcısından gelen isteklere izin verir.

   

8. Araç çubuğunda Kaydet'i seçin.

Daha fazla bilgi için bkz. Azure App Service'te CORS ile RESTful API barındırma.

API'nizi iş akışınızdan çağırma

API tanımı URL'sini ve CORS'yi ayarladıktan sonra API işlemleriniz, iş akışınızı bulup eklemeniz için bağlayıcı galerisinde görünür.

• OpenAPI URL'leri olan web sitelerini görüntülemek için iş akışı tasarımcısında abonelik web sitelerinize göz atabilirsiniz.

• Swagger belgesini işaret ederek kullanılabilir eylemleri ve girişleri görüntülemek için HTTP + Swagger tetikleyicisini veya eylemini kullanın.

• Swagger belgesi olmayan veya kullanıma sunmamış API'ler de dahil olmak üzere, herhangi bir API'yi çağırmak için HTTP eylemi ile her zaman bir istek oluşturabilirsiniz.

İlgili içerik

• Azure Logic Apps'te özel bağlayıcılar