Giriş
API Tüketicilerinin (API Consumers), bir organizasyonun sunduğu API’lerle ilgili dökümantasyona erişebilecekleri, bunları test edebilecekleri, belirli kısıtlamalar içinde kullanabilecekleri ve bu konular hakkında soru sorup cevaplayabilecekleri son kullanıcı veya geliştirici portalidir. API Geliştirici Portalı, diğer Apinizer ürünleri gibi Kubernetes Platformu üzerinde çalışır. Portal işlemleri için herhangi bir veritabanı kullanılmaz, bunun yerine doğrudan API Manager’ın sağladığı API’lerle etkileşim sağlanır.Kurulum Öncesi Adımlar
Apinizer API Portalı’nın kurulumuna başlamadan önce şunlara dikkat edilmelidir:Apinizer Kurulumu
API Manager kurulumunu öğrenin
Kurulum Adımları
API Portal Kurulumu iki şekilde yapılmaktadır.- Kubernetes yönetimi Apinizer üzerinden yapılıyorsa, API Manager üzerinden API Developer Portal kurulumu yapabilirsiniz.
- Kubernetes yönetimi Apinizer üzerinden yapılmıyorsa, Kubernetes’e manuel kurulum yapılabilir ve ardından API Manager ile bağlantı sağlanabilir.
Kişisel API Erişimi İçin Token Oluşturma
Token bilgileri, yeni bir token oluşturarak veya Profilim sayfasında mevcut bir token kullanılarak elde edilebilir. Personel tokenları genellikleapnz_ öneki ile başlar.
Token oluşturma işlemi için API Manager’da Profilim sayfasına giderek yeni bir token oluşturabilirsiniz.

API Developer Portal Kurulumu
API Developer Portal Kurulumu API Manager Üzerinden Yapılacaksa
API Manager üzerinden API Developer Portal kurulumu için Genel Ayarlar menüsünde aşağıdaki bölümün aktif olması gerekmektedir. API Manager’da, Yönetim → Sunucu Yönetimi → Kubernetes Resources sayfasına gidin. Deployment & Pods sekmesinden API Portal’ı etkinleştirin. Gerekli tanımları yaparak kurulumu tamamlayın.


| Alan | Açıklama |
|---|---|
| Apinizer Portal Management API URL | API Developer Portalin Apinizer Management API’lerini tüketebilmesi için gerekli olan API Manager tarafından çalıştırılan Management API adresidir. Örnek adres: http://<API_MANAGER_ACCESS_URL>:<PORT>/ |
| Apinizer Portal Management API Key/Token | API Developer Portalinin Apinizer Yönetim API’lerini tüketebilmesi için gereken token bilgisidir. |
| Sayısı (Count) | Gateway engine sayısı, Kubernetes Cluster’daki replicaSet ayarını düzenler. |
| Servis Portu (Service Port) | Gateway engine erişim portu, Kubernetes Cluster’daki servis objesinin NodePort ayarını düzenler. |
| Node Listesi (Node List) | Pod’ların hangi Kubernetes Worker sunucularında çalışacağını ayarlar. Kubernetes’teki NodeAffinity ayarını düzenler. |
| CPU | Pod’un kullanacağı maksimum CPU core sayısı bilgisidir. |
| Bellek (Memory) | Pod’un kullanacağı maksimum bellek değeridir. |
| Bellek Birimi (Memory Unit) | Bellek için gerekli olan değerin birimi seçilir; MB, GB. |
| Ek Değişkenler (Additional Variables) | Pod içinde çalıştırılacak varsayılan ve opsiyonel değişkenler ve değerleri tanımlanır. Varsayılan değişkenler silinemez, sadece değerleri düzenlenebilir. |
| Host Takma Adları (Host Aliases) | Ağda bulunan IP adresleri bazen host isimleri arkasına konulabilir, bunlar eğer nameserver ya da host dosyasına tanımlanmamışsa ya da bir şekilde Apinizer’ın bunları çözmesi sağlanamamışsa, worker podların bu isimleri çözmesi için Host Alias tanımı yapılmalıdır. |
Ek DeğişkenlerEk değişkenler alanındaki Java Options ayarını yapılandırırken aşağıdaki uyarı dikkate alınmalıdır:
- -Xmx ve -Xms parametreleri kullanıldığında, otomatik yığın (heap) boyutlandırması devre dışı bırakılır.
- Apinizer, JVM Yığın (Heap) değerlerini konteyner içinde çalıştığından konteynere verilen belleğin %75.0’ini kullanacak şekilde ayarlar.
- UseContainerSupport varsayılan olarak aktif gelmektedir.
- Eski bayraklar (flag) -XX: {Min | Max} RAMFraction artık kullanımdan kaldırıldı. 0.0 ve 100.0 arasında bir değer alan ve varsayılan olarak 75.0 olan yeni bir -XX: MaxRAMPercentage bayrağı (flag) vardır. Bu nedenle, 1 GB bellek sınırı varsa, JVM yığını (heap) varsayılan olarak ~ 750 MB ile sınırlıdır.
API Developer Portal Kurulumu API Manager Üzerinden Yapılmayacaksa
API Developer Portali’nin manuel olarak kurulması için aşağıdaki adımlar takip edilmelidir.- apinizerManagementApiBaseUrl: API Developer Portal’in Apinizer Management API’lerini tüketebilmesi için gerekli olan API Manager üzerinde çalışan Management API adresidir. Örnek bir adres:
http://apimanager-ui-ip-address:port - apiKey: API Developer Portal’in Apinizer Management API’lerini tüketebilmesi için gerekli olan token bilgisidir.
API Developer Portal’in API Manager ile Entegrasyonu
API Manager’da, Portal → Ayarlar → Portal sayfasına giderek, kurumunuza uygun tanımları yapınız. Detaylı bilgi için tıklayınız.API Developer Portal’i SSL ile Başlatma
İstenilen durumlarda API Developer Portal SSL ile erişime açılabilir. Detaylı bilgi için tıklayınız. Yukarıdaki adımlar tamamlandıktan ve Kubernetes üzerinde API Portal’e ait olan Pod’ların hazır durumda olduğundan emin olduktan sonra, Portal Arayüzüne erişmek için aşağıdaki adresten erişim sağlanabilir.Sonraki Adımlar
API Portal Genel Bakış
API Portal hakkında detaylı bilgi alın
API Integration Kurulumu
API Integration kurulumunu öğrenin
Multi-Region Kurulum
Multi-Region kurulumunu öğrenin
Apinizer Kurulumu
Apinizer kurulumunu öğrenin

