API Management hizmetini keşfedin

3 dakika

API Management, geliştirici katılımı, iş içgörüleri, analiz, güvenlik ve koruma aracılığıyla başarılı bir API programı sağlamak için temel işlevselliği sağlar. Her API bir veya daha fazla işlemden oluşur ve her API bir veya daha fazla ürüne eklenebilir. Bir API kullanmak için geliştiriciler bu API'yi içeren bir ürüne abone olur ve ardından geçerli olabilecek kullanım ilkelerine tabi olarak API'nin işlemini çağırabilir.

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.

API ağ geçidi şunları yapan uç noktadır:
- API çağrılarını kabul eder ve bunları uygun arka uçlara yönlendirir
- İsteklerle sunulan API anahtarlarını ve diğer kimlik bilgilerini doğrular
- Kullanım kotalarını ve hız sınırlarını uygular
- İlke deyimlerinde belirtilen istekleri ve yanıtları dönüştürür
- Yanıt gecikme süresini iyileştirmek ve arka uç hizmetlerindeki yükü en aza indirmek için yanıtları önbelleğe alır
- İzleme, raporlama ve sorun giderme için günlükleri, ölçümleri ve izlemeleri yayar
Yönetim düzlemi, API programınızı ayarladığınız yönetim arabirimidir. Bunu şunlar için kullanın:
- API Management hizmet ayarlarını sağlama ve yapılandırma
- API şemasını 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ı, API'lerinizin belgeleriyle birlikte otomatik olarak oluşturulmuş, tamamen özelleştirilebilir bir web sitesidir. 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

Ürünler

Ürünler API'lerin geliştiricilerin kullanımına nasıl sunulduğudur. API Management ürünleri bir ya da daha fazla API’ye sahiptir. Başlık, açıklama ve kullanım koşulları ile yapılandırılırlar. Ürünler Açık veya Korumalı olabilir. Korumalı ürünleri kullanabilmek için bunlara abone olmak gerekir, açık ürünler abonelik olmadan kullanılabilir. Abonelik onayı ürün düzeyinde yapılandırılır ve yönetici onayı gerektirebilir veya otomatik onaylanabilir.

Gruplar

Gruplar, ürünlerin geliştiricilere görünürlüğünü yönetmek için kullanılır. API Management şu sabit sistem gruplarına sahiptir:

Yöneticiler - 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 - Kimliği doğrulanmamış geliştirici portalı kullanıcıları. Api'leri görüntüleme ancak çağırmama gibi belirli salt okunur erişimler verilebilir.

Yöneticiler bu sistem gruplarına ek olarak özel gruplar oluşturabilir veya ilişkili Microsoft Entra kiracılarında dış grupları kullanabilir.

Geliştiriciler

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

İlkeler

İlkeler, bir API isteği veya yanıtı üzerinde sırayla yürütülen deyimlerin bir koleksiyonudur. Sık kullanılan deyimler, XML’den JSON’a biçim dönüştürmeyi ve bir geliştiriciden gelen çağrıların sayısını sınırlamak üzere çağrı hızını sınırlamayı ve çeşitli ilkeleri içerir.

İ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.