Bu dokümanda API Portal menüsüne nasıl erişilebileceği ve **API Portal’**de görüntülenecek olan API Proxy ve API Proxy Group’ları nasıl API Product olarak tanımlayabileceğiniz adım adım açıklanacaktır.
Portal Menüsüne ve API Product Tanımlama Ekranına Erişim
Apinizer API Portal ile API/Web Servisler merkezi bir yerden vitrin haline getirip API Kullanıcılarının kullanımına sunabilir, plan tanımlamalarınıza özel quota veya throttling politikalarıyla kullanıcıların sahip oldukları plana göre API tüketimini yönetebilirsiniz.
Bir API Proxy’i API Portal üzerinden yayınlamak için API Product tanımlaması yapılması gerekmektedir.
Portal menüsüne sadece admin menüleri üzerinden ve uygun yetkilerle erişim vardır.
“Portal” menüsü içerisinde bulunan “API Products” menüsüne girilerek sağ üstte bulunan Create butonuna tıklayarak yeni API Product tanımlaması için gerekli bilgilerin girişi gerçekleştirilir.
Burada seçeceğiniz API Proxy / API Proxy Group’un bir güvenlik politikası ile korunuyor olmasını, güvenlik politikası bulunmayan API Proxy / Proxy Group’un Portal kullanımına güvenlik sebebiyle açılmamasını tavsiye ediyoruz.
Burada seçilen aktif kullandığınız API Proxy / API Proxy Group’u direk yayınlamamanızı, farklı bir projede ilgili API Proxy / API Proxy Group’un bir replikasını API Portal üzerinde yayınlanmanızı tavsiye etmekteyiz.
Bu sayede bu API product’ınıza gelecek trafiği diğerinden yalıtarak, daha kontrollü bir ortam oluşturabilirsiniz.
API Product tanımlamaya başlamadan önce API Product tanımlı API Product’ları yönetmeyi kolaylaştıran Category ve Responsible Unit tanımlamaları yaparak onların da kullanımını görmek gerekir:
Responsible Unit / Category Tanımlama
Sol menüde Portal altında bulunan “Definitions” sekmesi altından “Responsible Units” ve “Categories” menüleri içerisinden yeni Responsible Units ve Category tanımlaması yapabilir, var olan Responsible Unit ve Categoryleri görüntüleyebilir, düzenleyebilirsiniz.
Responsible Unit Tanımlama
Portal menüsü altında bulunan Definitions bölümünden Responsible Unit sayfasına girerek mevcut Responsible Unit’lerinizi görüntüleyebilir, güncelleyebilir veya bir yenisini ekleyebiliriz.
Responsible Unit, API Product’lardan sorumlu birimi temsil eder.
Yeni bir Responsible Unit tanımlamak veya var olanları görüntülemek, düzenlemek için Portal sekmesi altında bulunan Definitions menüsü içerisinden Responsible Unit’e tıklanır.
Açılan sayfada Responsible Unitleri görüntüleyebilir, güncelleyebilir ve yeni bir tane oluşturabiliriz.
Yeni bir Responsible Unit oluşturmak için sağ üstte bulunan Create butonu tetiklenir.
Save butonu tetiklendikten sonra açılan sayfadaki alanlar doldurarak yeni bir Responsible Unit tanımlaması gerçekleştirilir.
Parent Unit, ilgili Responsible Unit’in bağlı olduğu birimi referans göstermektedir. Burada alt birim - üst birim ilişkisi kurularak Responsible Unit tanımlaması gerçekleştirilmesi tarafımızca tavsiye edilir. listeleme ekranında üst birimleri ilgili birim tanımlamalarının yanında görüntüleyerek yönetimini gerçekleştirebilirsiniz.
Category Tanımlama
Category tanımlaması, API Product’ları kategorilere dahil ederek API Portal üzerinden arama yapıldığında kategoriye göre filtrelenerek gelişmiş arama yapılabilmesini sağlar.
Yeni Category tanımlaması yapmak için Portal menüsü içerisinden Definitions sekmesi altından Categories sayfasına gitmemiz gerekir.
Categories sayfası içerisinde daha önce tanımlanmış Category’leri görüntüleyebilir, güncelleyebilir veya yeni bir tane ekleyebilirsiniz.
Create butonu tetiklenerek yeni bir Category tanımlaması gerçekleştirilebilir.
Tanımlanmak istenen Category’nin ismini girerek save tuşu tetiklenir.
Categories sayfası içerisinde listeleme ekranında yeni eklemiş olduğumuz Category’i görüntülüyor olacağız.
API Product Tanımlama Ve Tanımlanan API Product’ın API Portal Üzerinde Yayınlanması
Aşağıdaki görsellerde bulunan ekran üzerinden gerekli alanları doldurarak API Product tanımlaması yapabiliriz.
API Product tanımlamayla ilgili alanları daha detaylı olarak API Ürünleri sayfasından inceleyebilirsiniz.
Örnek bir tanımlamaya aşağıdaki ekran görüntülerinde yer verilmiştir.
Visibility ve Plan & Monetization alanları API Product tanımlaması için fazlasıyla önem arz etmektedir.
İlgili alanlar hakkında daha detaylı bilgi edinmek için API Ürünleri sayfasını inceleyebilirsiniz.
Public: API Product, API Portal’a üye olan / olmayan herkesçe görüntülenebilir.
Only Logged In Organizations: API Product’ı sadece giriş yapan kurumlar görebilir.
Authorized Organizations: API Product için yetkilendirilmiş kurumlar görüntüleyebilir.
Free: Ücretsiz bir şekilde API Product’ın tüketilmesini sağlar
Subscription: Aylık veya yıllık abonelik sistemi üzerine çalışır. Tüketim aşım durumunda ek ücretlendirmeler veya durdurma işlemleri gerçekleştirilebilir.
Metered: İstek başına ücretlendirme uygulanır.
Tiered: Katmanlı bir ödeme planı oluşturulur.
İhtiyaca göre quota veya throttling hangi plan seçilirse seçilsin uygulanabilir.
Plan seçim adımında Enable Throttling veya Enable Quota seçenekleri aktif edilerek API Product’ın istek akışı limitlendirilebilir.
Aşağıdaki görselde Free plan seçimi yapılmış ve dakikada 50 istek sınırı olacak şekilde Throttling uygulaması gerçekleştirilmiştir.
Save butonuna basarak API Product tanımlaması tamamlanır.
API Product tanımlamasından sonra API Portal tarafında API Product’ın yayınlanabilmesi için sağ üst köşede bulunan “unpublished” butonunun tetiklenmesi ve açılan popup üzerinden publish edillmesi gerekir.
Yukarıdaki adımları tamamladıktan sonra API Products liste ekranında yayınlanan API Product’ı published statüsüne sahip bir şekilde görüntüleyebiliyor olacağız.
