Özel bağlayıcı oluşturma: kendi API'nizi Power Automate'e taşıyın

Power Automate'teki özel bir bağlayıcı, 1.000'den fazla hazır bağlayıcıdan hiçbiri sisteminize uymadığında kullandığınız, kendinizin oluşturduğu bir REST veya SOAP API sarmalayıcısıdır (wrapper). Bunu bir OpenAPI tanımı, bir Postman koleksiyonu veya doğrudan bağlayıcı portalı üzerinden oluşturursunuz, erişimi Microsoft Entra ID veya OAuth 2.0 gibi standart bir kimlik doğrulama yöntemiyle güvence altına alırsınız ve bunun için en az bir Power Automate Premium veya Process lisansına ihtiyacınız vardır, çünkü Free katmanı yalnızca standart bağlayıcılara izin verir. Güncelleme tarihi: Ağustos 2026.

Özel bağlayıcı tam olarak nedir?

Özel bağlayıcı teknik olarak bir REST API'sinin, Logic Apps'te ayrıca bir SOAP API'sinin de sarmalayıcısıdır ve Power Automate, Power Apps veya Copilot Studio'nun hazır bir bağlayıcısı bulunmayan bir sistemle konuşmasını sağlar. API, internette herkese açık olarak erişilebilir olabilir, örneğin kendi barındırdığınız bir REST arayüzü, ya da kendi ağınızda özel olarak bulunabilir; özel API'ler için Microsoft bu amaçla bir şirket içi (on-premises) veri ağ geçidi sunar. Genel kavrama ilişkin ayrıntılar Microsoft'un özel bağlayıcılara genel bakış sayfasında açıklanmaktadır.

Bağlayıcıyı somut olarak nasıl oluştururum?

Bağlayıcıyı tanımlamak için üç yolunuz vardır: bir OpenAPI tanımı (eskiden Swagger dosyası) üzerinden, içe aktarılmış bir Postman koleksiyonu üzerinden veya bağlayıcı sihirbazında tamamen sıfırdan oluşturarak. Microsoft'a göre son yol yalnızca Power Automate ve Power Apps'te kullanılabilir, Logic Apps'te değil; buna karşın OpenAPI veya Postman tanımı orada da bağlayıcıyı ayrıca yeniden oluşturmak için yeniden kullanılabilir. Çözümlerde (Solutions) onu "Yeni > Otomasyon > Özel bağlayıcı" üzerinden oluşturursunuz.

API bağlantısını nasıl güvence altına alırım?

Kimlik doğrulama için Microsoft Entra ID'nin önerildiği birkaç standart yöntem mevcuttur: genel OAuth 2.0, örneğin Dropbox veya GitHub için hizmete özgü OAuth 2.0, temel kimlik doğrulama veya bir API anahtarı. Mevcut bağlayıcılar için önemli bir nokta: yeni oluşturulan OAuth 2.0 bağlayıcıları otomatik olarak bağlayıcı başına kendi yönlendirme URI'sini alır, eski bağlayıcıların 17 Şubat 2024 itibarıyla buna geçirilmesi gerekiyordu, aksi takdirde yeni bağlantılar artık çalışmaz. Eski bir bağlayıcı işletiyorsanız, benzersiz yönlendirme URL'sinin zaten etkinleştirilip etkinleştirilmediğini görmek için güvenlik ayarlarına bir göz atmakta fayda vardır.

Bunun için hangi lisansa ihtiyacım var?

Özel bir bağlayıcıyı kullanabilmek için en az bir Power Automate Premium veya bir Process lisansına ihtiyacınız vardır; ücretsiz Power Automate Free lisansı Microsoft'a göre açıkça yalnızca standart bağlayıcılarla sınırlıdır. Premium, Process ve Hosted Process lisansları özel bağlayıcılar için yetkiyi her biri tam olarak içerir, tek tek her bağlayıcı için ayrı bir ek ücret yoktur. Şirketiniz için hangi lisans düzeyinin uygun olduğuna karar verirken, NordFlux olarak Power Automate lisans danışmanlığımız kapsamında size destek oluyoruz.

Bağlayıcıyı ekipte nasıl paylaşırım ve Logic Apps için ne geçerlidir?

Bağlayıcıyı kuruluşunuz içinde paylaşırsınız, Power Automate, Power Apps veya Copilot Studio'daki diğer kaynaklara benzer şekilde; bu isteğe bağlıdır ancak birden fazla meslektaşınızın onu kullanması gerektiğinde faydalıdır. Power Automate'te oluşturulan bir bağlayıcı otomatik olarak Power Apps ve Copilot Studio'da da kullanılabilir hale gelir, tersi de geçerlidir, ancak bu otomatik olarak Logic Apps için geçerli değildir. Bağlayıcının Power Automate, Power Apps, Logic Apps ve Copilot Studio'nun tüm kullanıcıları için görünür hale gelmesi gerekiyorsa, onu ayrıca Microsoft sertifikasyonuna göndermeniz gerekir. Bağlayıcı sertifikasyonuna genel bakış sayfasına göre, sertifikasyon her iki yayıncı türü için de ücretsizdir, ancak desteklenen bir kimlik doğrulama yöntemi (OAuth 2.0, anonim kimlik doğrulama, API anahtarı veya temel kimlik doğrulama), adı belirtilen bir destek kişisi gerektirir ve en az yüzde 99,9 kullanılabilirlik önerir.

Power Automate'teki özel bağlayıcılar hakkında sık sorulan sorular

Özel bir bağlayıcı için programlama bilgisine ihtiyacım var mı?

Bağlayıcı sihirbazı üzerinden en basit yol için hedef API'nin yapısı hakkında temel bilgi yeterlidir, klasik anlamda programlama kesinlikle gerekli değildir. Ancak kendiniz bir OpenAPI tanımı yazdığınızda veya kendi API'nizin kodunda Microsoft Entra ID gibi daha karmaşık bir kimlik doğrulama uyguladığınızda, teknik bilgi birikimi belirgin şekilde daha yararlı hale gelir.

Özel bir bağlayıcı lisansa ek olarak bir ücrete mi mal olur?

Hayır, Microsoft'a göre özel bağlayıcıların kullanımı Premium, Process ve Hosted Process lisanslarına zaten dahildir, dokümantasyon bağlayıcı başına ayrı bir ücretten söz etmemektedir. Maliyetler aslında, bu lisans düzeyleri olmadan hiçbir özel bağlayıcı kullanamamanızdan kaynaklanır, çünkü Free lisansı bunları hariç tutar.

Özel bir bağlayıcıyı Power Apps'te de kullanabilir miyim?

Evet, Microsoft'a göre Power Automate'te oluşturulan özel bir bağlayıcı otomatik olarak Power Apps ve Copilot Studio'da da kullanılabilir. Logic Apps için bu doğrudan geçerli değildir, ancak orada da aynı OpenAPI tanımı veya Postman koleksiyonu yeniden kullanılabilir.

Temel alınan API değişirse ne olur?

API'de bir alan değiştiğinde, güncellenmiş Swagger'ın devralınması için bağlayıcıyı yeniden yayımlamanız ve ardından etkilenen bağlantıları tüm uygulamalardan kaldırıp yeniden eklemeniz gerekir. Bu adım olmadan uygulamalar ve akışlar eski bağlayıcı tanımıyla çalışmaya devam eder ve farklı alanlarda hata verebilir.