Azure API Management nedir?

Bu makalede Azure API Management'ın yaygın senaryolarına ve temel bileşenlerine genel bir bakış sağlanmaktadır. Azure API Management, tüm ortamlarda API'ler için karma, çoklu bulut yönetim platformudur. Hizmet olarak platform olarak API Management, API yaşam döngüsünün tamamını destekler.

Bahşiş

API Management'ı zaten biliyor ve başlamaya hazırsanız şu kaynaklara bakın:

Senaryolar

API'ler dijital deneyimlere olanak tanır, uygulama tümleştirmesini basitleştirir, yeni dijital ürünlerin temellerini oluşturur ve veri ve hizmetleri yeniden kullanılabilir ve evrensel olarak erişilebilir hale getirir. API'lerin yaygınlaşması ve artan bağımlılığıyla birlikte, kuruluşların yaşam döngüleri boyunca bunları birinci sınıf varlıklar olarak yönetmesi gerekir.

Diagram showing role of APIs in connected experiences.

Azure API Management, müşterilerin şu zorlukları karşılamalarına yardımcı olur:

  • API tüketicilerinden soyut arka uç mimarisi çeşitliliği ve karmaşıklığı
  • Azure üzerinde ve dışında barındırılan hizmetleri API'ler olarak güvenli bir şekilde kullanıma sunma
  • API'leri koruma, hızlandırma ve gözlemleme
  • api bulma ve iç ve dış kullanıcılar tarafından tüketimi etkinleştirme

Yaygın senaryolar şunlardır:

  • Eski varlıkların kilidini açma - API'ler eski arka uçları soyutlayıp modernleştirmek ve bunları yeni bulut hizmetlerinden ve modern uygulamalardan erişilebilir hale getirmek için kullanılır. API'ler geçiş riski, maliyeti ve gecikmeleri olmadan yeniliklere olanak sağlar.
  • API merkezli uygulama tümleştirmesi - API'ler, verileri, uygulamaları ve işlemleri kullanıma sunmak ve bunlara erişmek için kolayca kullanılabilir, standartlara dayalı ve kendini açıklayan mekanizmalardır. Uygulama tümleştirme maliyetini basitleştirir ve azaltır.
  • Çok kanallı kullanıcı deneyimleri - API'ler sıklıkla web, mobil, giyilebilir veya Nesnelerin İnterneti uygulamaları gibi kullanıcı deneyimlerini etkinleştirmek için kullanılır. Geliştirme ve yatırım getirisini hızlandırmak için API'leri yeniden kullanın.
  • B2B tümleştirmesi - İş ortaklarının ve müşterilerin kullanımına sunulan API'ler, iş süreçlerini tümleştirme ve iş varlıkları arasında veri alışverişinde bulunma engelini düşürür. API'ler noktadan noktaya tümleştirmenin doğasında bulunan ek yükü ortadan kaldırır. Özellikle self servis bulma ve ekleme etkinleştirildiğinde, API'ler B2B tümleştirmesini ölçeklendirmeye yönelik birincil araçlardır.

API Management bileşenleri

Azure API Management bir API ağ geçidi, bir yönetim düzlemi ve geliştirici portalından oluşur. Bu bileşenler Azure tarafından barındırılan ve varsayılan olarak tamamen yönetilen bileşenlerdir. API Management, kapasite ve özellikler bakımından farklı katmanlarda kullanılabilir.

Diagram showing key components of Azure API Management.

API ağ geçidi

İstemci uygulamalarından gelen tüm istekler önce API ağ geçidine ulaşır ve ardından bunları ilgili arka uç hizmetlerine iletir. API ağ geçidi, arka uç hizmetlerine yönelik bir cephe işlevi görerek API sağlayıcılarının API uygulamalarını soyutlamalarına ve API tüketicilerini etkilemeden arka uç mimarisini geliştirmelerine olanak sağlar. Ağ geçidi yönlendirme, güvenlik, azaltma, önbelleğe alma ve gözlemlenebilirliğin tutarlı bir şekilde yapılandırılmasını sağlar.

Özellikle ağ geçidi:

Şirket içinde barındırılan ağ geçidi

Şirket içinde barındırılan ağ geçidiyle, müşteriler API trafiğini iyileştirmek ve yerel düzenlemelere ve yönergelere uyumluluğu sağlamak için API ağ geçidini API'lerini barındırdıkları ortamlara dağıtabilir. Şirket içinde barındırılan ağ geçidi, hibrit BT altyapısına sahip müşterilerin Azure'daki tek bir API Management hizmetinden şirket içinde ve bulutlar arasında barındırılan API'leri yönetmesini sağlar.

Şirket içinde barındırılan ağ geçidi Linux tabanlı bir Docker kapsayıcısı olarak paketlenir ve Azure Kubernetes Service ve Azure Arc özellikli Kubernetes dahil olmak üzere genellikle Kubernetes'e dağıtılır.

Daha fazla bilgi:

Yönetim düzlemi

API sağlayıcıları, API Management hizmet özelliklerine tam erişim sağlayan yönetim düzlemi aracılığıyla hizmetle etkileşim kurar.

Müşteriler azure portalı, Azure PowerShell, Azure CLI, Visual Studio Code uzantısı, REST API veya çeşitli popüler programlama dillerindeki istemci SDK'ları gibi Azure araçları aracılığıyla yönetim düzlemiyle etkileşim kurar.

Yönetim düzlemini kullanarak:

  • API Management hizmet ayarlarını sağlama ve yapılandırma
  • OpenAPI, WSDL ve OData tanımları, Azure işlem hizmetleri ve WebSocket, GraphQL ve gRPC arka uçları dahil olmak üzere çok çeşitli kaynaklardan API şemaları tanımlama veya içeri aktarma
  • API'leri ürünlere paketleme
  • API'lerde kotalar veya dönüşümler gibi ilkeler ayarlama
  • Analizden içgörüler alma
  • Kullanıcıları yönet

Geliştirici portalı

Açık kaynak geliştirici portalı , API'lerinizin belgeleriyle otomatik olarak oluşturulmuş, tamamen özelleştirilebilir bir web sitesidir.

Screenshot of API Management developer portal - administrator mode.

API sağlayıcıları özel içerik ekleyerek, stilleri özelleştirerek ve markalarını ekleyerek geliştirici portalının genel görünümünü özelleştirebilir. Kendi kendine barındırarak geliştirici portalını daha da genişletin.

Uygulama geliştiricileri API'leri keşfetmek, kullanmak üzere ekleme yapmak ve uygulamalarda kullanmayı öğrenmek için açık kaynak geliştirici portalını kullanır. (API'ler Vatandaş geliştiriciler tarafından keşfetmek ve kullanmak için Power Platform .)

Geliştiriciler, geliştirici portalını kullanarak şunları yapabilir:

  • API belgelerini okuma
  • Etkileşimli konsol aracılığıyla API çağırma
  • Hesap oluşturma ve API anahtarlarını almak için abone olma
  • Kendi kullanımlarında analize erişme
  • API tanımlarını indirme
  • API anahtarlarını yönetme

Azure hizmetleriyle tümleştirme

API Management, aşağıdakiler dahil olmak üzere kurumsal çözümler oluşturmak için birçok tamamlayıcı Azure hizmetiyle tümleştirilir:

Daha fazla bilgi:

Temel kavramlar

API'ler

API'ler bir API Management hizmet örneğinin temelini oluşturur. Her API, uygulama geliştiricilerin kullanabileceği bir dizi işlemi temsil eder. Her API, API'yi uygulayan arka uç hizmetine bir başvuru içerir ve işlemleri arka uç işlemleriyle eşler.

API Management işlemleri; URL eşleme, sorgu ve yol parametreleri, istek ve yanıt içeriği ve işlem yanıtını önbelleğe alma üzerinde sahip olunan denetim sayesinde yüksek oranda yapılandırılabilir niteliktedir.

Daha fazla bilgi:

Ürünler

Ürünler API'lerin geliştiricilerin kullanımına nasıl sunulduğudur. API Management'taki ürünler bir veya daha fazla API'ye sahiptir ve açık veya korunabilir. Korumalı ürünler için abonelik anahtarı gerekirken, açık ürünler serbestçe kullanılabilir.

Bir ürün, geliştiriciler tarafından kullanılmaya hazır olduğunda yayımlanabilir. Yayımlandıktan sonra, geliştirici portalı kullanılarak geliştiriciler tarafından görüntülenebilir veya abone olunabilir. Abonelik onayı ürün düzeyinde yapılandırılır ve bir yönetici onayı gerektirebilir ya da otomatik olarak onaylanır.

Daha fazla bilgi:

Gruplar

Gruplar, ürünlerin geliştiricilere görünürlüğünü yönetmek için kullanılır. API Management aşağıdaki yerleşik gruplara sahiptir:

  • Yönetici istrators - API Management hizmet örneklerini yönetin ve geliştiriciler tarafından kullanılan API'leri, işlemleri ve ürünleri oluşturun.

    Azure aboneliği yöneticileri bu grubun üyeleridir.

  • Geliştiriciler - API'lerinizi kullanarak uygulama oluşturan kimliği doğrulanmış geliştirici portalı kullanıcıları. Geliştiriciler, geliştirici portalına erişim iznine sahiptir ve bir API’nin işlemlerini çağıran uygulamalar oluşturur.

  • Konuklar - Geliştirici portalını ziyaret eden potansiyel müşteriler gibi kimliği doğrulanmamış geliştirici portalı kullanıcıları. Bunlara API’leri görüntüleyebilme ancak çağıramama gibi bazı salt okunur erişimler verilebilir.

Yönetici istrator'lar ayrıca özel gruplar oluşturabilir veya geliştiricilere API ürünlerine görünürlük ve erişim sağlamak için ilişkili bir Microsoft Entra kiracısında dış gruplar kullanabilir. Örneğin, bir iş ortağı kuruluşundaki geliştiricilerin bir üründeki API'lerin belirli bir alt kümesine erişmesi için özel bir grup oluşturun. Bir kullanıcı birden fazla gruba ait olabilir.

Daha fazla bilgi:

Geliştiriciler

Geliştiriciler API Management hizmet örneğindeki kullanıcı hesaplarını temsil eder. Geliştiriciler yöneticiler tarafından oluşturulabilir veya davet edilebilir ya da geliştirici portalından kaydolabilir. Her geliştirici bir veya daha fazla grubun üyesidir ve bu gruplara görünürlük sağlayan ürünlere abone olabilir.

Geliştiriciler bir ürüne abone olduğunda, ürünün API'lerini çağırırken kullanılacak ürün için birincil ve ikincil anahtar verilir.

Daha fazla bilgi:

Çalışma Alanları

Çalışma alanları merkezi olmayan API geliştirme ekiplerinin kendi API'lerini yönetmesine ve ürünleştirmesine olanak tanırken, merkezi bir API platformu ekibi API Management altyapısını korur. Her çalışma alanı API'leri, ürünleri, abonelikleri ve yalnızca çalışma alanı ortak çalışanları tarafından erişilebilen ilgili varlıkları içerir. Erişim, Azure rol tabanlı erişim denetimi (RBAC) aracılığıyla denetlenir.

Daha fazla bilgi:

İlkeler

İlkelerle, API yayımcısı yapılandırma aracılığıyla API'nin davranışını değiştirebilir. İlkeler, bir API isteği veya yanıtı üzerinde sırayla yürütülen deyimlerin bir koleksiyonudur. Popüler deyimler, XML'den JSON'a biçim dönüştürmeyi ve bir geliştiriciden gelen çağrı sayısını kısıtlamak için çağrı hızı sınırlamasını içerir. Tam liste için bkz . API Management ilkeleri.

İlke ifadeleri herhangi bir API Management ilkesinde, ilke aksini belirtmedikçe, öznitelik değerleri ya da metin değerleri olarak kullanılabilir. Akışı denetle ve Değişken ayarla gibi bazı ilkeler ilke ifadelerini temel alır.

İlkeler gereksinimlerinize bağlı olarak farklı kapsamlarda uygulanabilir: genel (tüm API'ler), çalışma alanı, ürün, belirli bir API veya API işlemi.

Daha fazla bilgi:

Sonraki adımlar

Şu hızlı başlangıcı tamamlayarak Azure API Management'i kullanmaya başlayın: