API ağ geçidi oluşturma
Kuruluşlar genellikle verilerini iş ortaklarının kullanımına açmak ister. Bu erişimin denetlenmesi ve yönetilmesi gerekir.
Ayakkabı şirketi örneğinde NorthWind Shoes için stok sağlayan bayiler ne kadar stok siparişi geçebileceklerini bilmek istiyor. Müşteriler ayrıca siparişlerini tam olarak ne zaman alacaklarını bilmek ister.
Burada Azure API Management'ın nasıl çalıştığını ve API ağ geçidi ayarlamayı öğreneceksiniz.
Azure API Management
Azure API yönetim hizmeti Azure bulutunda barındırılır ve API'lerinizle İnternet arasında konumlandırılır. API Management örneğiniz bir Azure API ağ geçidi işlevi görür.
API'lerinizi yayımladığınızda bu API'lerin ne ölçüde müşterilerin kullanımına sunulacağını denetlemek için Azure portalını kullanırsınız. Bazı API'lerin tanıtım amacıyla geliştiriciler tarafından serbest bir şekilde kullanılmasını, bazıları için de sıkı bir denetim sağlanmasını isteyebilirsiniz.
API Management'ı neden kullanmalısınız?
API Management geliştiriciler için birçok avantaj sağlar.
- API belgeleri. API'lerin belgeleri, çağrı gönderen istemcilerin çözümlerini hızlı bir şekilde tümleştirmesini sağlar. API Management, OpenAPI gibi modern standartlar aracılığıyla API'nizin yapısını hızlı bir şekilde istemcileri çağırmaya sunmanızı sağlar. API'nizin birden fazla sürümü olabilir. Birden fazla sürüm sayesinde tüketim uygulamalarınız yeni sürümü hemen kullanmak zorunda olmayacağından uygulama güncelleştirmelerini kademeli bir şekilde gerçekleştirebilirsiniz.
- Hızı sınırlama erişimi. API'niz büyük miktarda veriye erişme imkanına sahipse istemcilerin veri isteğinde bulunma hızını sınırlamak iyi bir fikir olabilir. Hız sınırlaması, her istemcinin en uygun yanıt süresine sahip olmasına yardımcı olur. API Management, hız sınırlarını bir bütün olarak veya belirli tek tek istemciler için ayarlamanıza olanak tanır.
- Sistem durumunu izleme. Uzak istemciler API'lerinizi kullanır, bu nedenle olası sorunları veya hataları belirlemek zor olabilir. API Management, hata yanıtlarını ve günlük dosyalarını görüntülemenizi ve yanıt türüne göre filtreleme yapmanızı sağlar.
- JSON gibi modern biçimler. API'ler yıllar boyunca XML'den CSV'ye kadar birçok farklı veri aktarma biçimi kullanmıştır. API Management, JSON gibi modern veri modellerini kullanarak verileri bu biçimlerde kullanıma sunmanızı sağlar.
- Herhangi bir API'ye bağlanma. Birçok işletmede API'ler farklı ülkelerde/bölgelerde bulunur ve farklı biçimler kullanır. API Management, bu farklı API'lerin tümünü tek bir modern arabirime eklemenize olanak tanır.
- Analizler. API'lerinizi geliştirirken hangi sıklıkta ve hangi türdeki sistemler tarafından çağrıldıklarını görmek kullanışlı olacaktır. API Management sayesinde bu verileri Azure portalında görselleştirebilirsiniz.
- Güvenlik. Sistem verileri söz konusu olduğunda güvenlik birinci sırada yer alır. Şirketler, yetkisiz ihlaller nedeniyle zarar edebilir, kodun düzenlenmesi zaman alabilir ve itibar kaybı yaşanabilir. Azure API management ile kullanabileceğiniz güvenlik araçları arasında OAuth 2.0 kullanıcı yetkilendirmesi ve Microsoft Entra Id ile tümleştirme yer alır.
- Fiyatlandırma katmanları. API Management, istek aktarım hızı, SLA, ağ yalıtımı, yükseltme esnekliği vb. için farklı özelliklere sahip katmanlar sunar. Azure API management ağ geçidi oluşturduğunuzda gereksinimlerinizi karşılayan katmanı seçersiniz.
API Management kurulumu
API Management'ı kurmak için şunları yapmanız gerekir:
- API Management ağ geçidi oluşturun. Ağ geçidi için kullandığınız adın .azure-api.net ad alanında genel olarak benzersiz olması gerekir.
- Mevcut bir web API'sini ağ geçidine kaydedin. Tüketiciler, kaydedilen API'lere <gateway>.azure-api.net uç noktası üzerinden erişebilir.
- Ağ geçidinden var olan bir API'yi çağırın. Tüketiciler artık uç nokta URL'sinde API'yi çağırabilir.