Çoklu Portal Nedir?
API Developer Multi Portal (Çoklu Portal) özelliği, Apinizer platformunda birden fazla bağımsız API Developer Portal oluşturmanıza ve yönetmenize olanak tanır. Her portal, kendi kullanıcıları, API’leri, ayarları ve görünümü ile tamamen bağımsız bir ortam olarak çalışır.Basit Bir Örnekle Açıklama
Düşünün ki bir şirketsiniz ve farklı gruplara hizmet veriyorsunuz: Senaryo 1: Farklı Departmanlar- Satış Ekibi Portalı: Satış ekibiniz için özel API’ler ve dokümantasyon
- Müşteri Hizmetleri Portalı: Müşteri hizmetleri ekibiniz için farklı API’ler
- IT Departmanı Portalı: Teknik ekip için gelişmiş API’ler
- Partner Şirketler Portalı: İş ortaklarınız için özel API’ler
- Genel Kullanıcı Portalı: Halka açık API’ler
- Premium Müşteri Portalı: Özel müşterileriniz için premium API’ler
- Test Portalı: Geliştirme ve test için
- Production Portalı: Canlı sistem için
- Demo Portalı: Tanıtım ve demo için
Çoklu Portal’ın Avantajları
Bağımsızlık
Her portal kendi ayarlarına, kullanıcılarına ve API’lerine sahiptir. Bir portalda yapılan değişiklik diğerlerini etkilemez.
Özelleştirme
Her portal için farklı logo, renk şeması, tema ve içerik kullanabilirsiniz. Her portal kendi markasına sahip olabilir.
Güvenlik ve İzolasyon
Her portalın kendi güvenlik ayarları vardır. Kullanıcılar sadece yetkili oldukları portala erişebilir.
Esneklik
Farklı portallar için farklı özellikler aktif edebilirsiniz. Örneğin birinde Analytics açık, diğerinde kapalı olabilir.
Yönetim Kolaylığı
Her portal için farklı yöneticiler atayabilirsiniz. Departmanlar kendi portallarını bağımsız yönetebilir.
Ölçeklenebilirlik
İhtiyacınız olduğu kadar portal oluşturabilirsiniz. Her portal ayrı ayrı ölçeklendirilebilir.
Çoklu Portal Nasıl Çalışır?
Tek Bir Platform, Birden Fazla Portal Apinizer platformunda, tek bir yönetim panelinden tüm portallarınızı yönetebilirsiniz:-
Portal Oluşturma: Yeni bir portal oluşturduğunuzda, sistem otomatik olarak:
- Portal için benzersiz bir URL oluşturur
- Ayrı bir veritabanı alanı ayırır
- Bağımsız bir çalışma ortamı hazırlar
-
Portal Yönetimi: Her portal için:
- Kendi ayarlarını yapabilirsiniz
- Kendi kullanıcılarını ekleyebilirsiniz
- Kendi API’lerini yayınlayabilirsiniz
- Kendi görünümünü özelleştirebilirsiniz
-
Portal Erişimi: Her portal:
- Kendi URL’sine sahiptir (örn:
https://api.company.com/portal/partner-portal) - Kendi giriş sayfasına sahiptir
- Kendi kullanıcı hesaplarına sahiptir
- Kendi URL’sine sahiptir (örn:
Portal İzolasyonu
Her portal, teknik olarak tamamen izole bir yapıda çalışır:| Bileşen | Açıklama |
|---|---|
| Namespace | Her portal kendi ad alanında çalışır, diğer portallardan ayrıdır |
| Pod | Her portal kendi çalışma biriminde (pod) çalışır |
| Secret | Her portalın kendi güvenlik anahtarları ve şifreleri vardır |
| Service | Her portal kendi servis yapılandırmasına sahiptir |
- Bir portalda oluşan bir sorun diğerlerini etkilemez
- Güvenlik açıkları bir portaldan diğerine yayılmaz
- Performans sorunları izole kalır
Bağımsız Konfigürasyon
Her portalın tüm ayarları ve konfigürasyonları birbirinden bağımsızdır:Görünüm ve Tema Ayarları
Görünüm ve Tema Ayarları
Her portal için farklı:
- Logo ve marka görseli
- Renk şeması (ana renk, ikincil renk, arka plan)
- Font ayarları
- Ana sayfa içeriği
- Footer içeriği
Güvenlik ve Erişim Kontrolü
Güvenlik ve Erişim Kontrolü
Her portal için farklı:
- Kullanıcı kayıt izinleri (açık/kapalı)
- Otomatik onay ayarları
- API abonelik onay süreçleri
- Credential yönetim izinleri
- IP kısıtlamaları
Kullanıcı ve Rol Yönetimi
Kullanıcı ve Rol Yönetimi
Her portal için farklı:
- Kullanıcı hesapları (bir kullanıcı birden fazla portala kayıt olabilir)
- Kullanıcı rolleri ve yetkileri
- Portal yöneticileri
- Organizasyon yapıları
API ve İçerik Yönetimi
API ve İçerik Yönetimi
Her portal için farklı:
- Yayınlanan API ürünleri
- API dokümantasyonları
- Fiyatlandırma planları
- İçerik sayfaları
- Dosyalar ve kaynaklar
Özellik Ayarları
Özellik Ayarları
Her portal için farklı:
- Try It Out (test konsolu) aktif/pasif
- Analytics özelliği aktif/pasif
- Jira entegrasyonu aktif/pasif
- How to Use menüsü aktif/pasif
Dil ve Yerelleştirme
Dil ve Yerelleştirme
Her portal için farklı:
- Varsayılan dil (Türkçe/İngilizce)
- Çoklu dil desteği (açık/kapalı)
- Dil içerikleri
Ne Zaman Çoklu Portal Kullanmalısınız?
Çoklu Portal özelliğini aşağıdaki durumlarda kullanmanız önerilir:- Farklı Müşteri Segmentleri
- Farklı Departmanlar/Birimler
- Farklı Ortamlar
- Farklı Bölgeler/Diller
Kullanım Senaryosu:
- Farklı müşteri gruplarına farklı API’ler sunuyorsunuz
- Partner şirketler için özel bir portal istiyorsunuz
- Premium müşteriler için ayrı bir deneyim sunmak istiyorsunuz
Çoklu Portal vs Tek Portal
| Özellik | Tek Portal | Çoklu Portal |
|---|---|---|
| Kullanıcı Yönetimi | Tüm kullanıcılar aynı portala erişir | Her portal kendi kullanıcılarına sahiptir |
| API Yönetimi | Tüm API’ler tek yerde | Her portal kendi API’lerini yayınlar |
| Özelleştirme | Tek bir görünüm | Her portal farklı görünüme sahip olabilir |
| Güvenlik | Tek güvenlik politikası | Her portal kendi güvenlik ayarlarına sahip |
| Yönetim | Merkezi yönetim | Her portal bağımsız yönetilebilir |
| Esneklik | Sınırlı | Yüksek esneklik |
| Karmaşıklık | Basit | Daha karmaşık (ama daha güçlü) |
Özet
Çoklu Portal, Apinizer platformunda birden fazla bağımsız API Developer Portal oluşturmanıza ve yönetmenize olanak tanır. Her portal: ✅ Kendi kullanıcılarına sahiptir✅ Kendi API’lerini yayınlar
✅ Kendi görünümüne sahiptir
✅ Kendi ayarlarına sahiptir
✅ Tamamen bağımsız çalışır Bu sayede farklı müşteri grupları, departmanlar veya ortamlar için özelleştirilmiş portal deneyimleri sunabilir, her birini bağımsız olarak yönetebilirsiniz.
Ön Koşullar
Kurulum için API Developer Multi Portal Kurulumu dokümanını inceleyiniz.Portal Listeleme ve Görüntüleme
Portal Listesine Erişim
1
Manager Arayüzüne Giriş
Apinizer Manager arayüzüne giriş yapın
2
Portal Sekmesine Git
Üst menü çubuğunda bulunan Portal sekmesine tıklayın
3
Portal Listesini Görüntüle
Portal listesi otomatik olarak yüklenir ve tüm portallar görüntülenir
Portal Liste Ekranı
Yeni Portal Oluşturma
Yeni bir API Developer Portal oluşturmak için aşağıdaki adımları takip edin:1
Portal Oluşturma Ekranına Erişim
- Üst menü çubuğunda bulunan Portal sekmesine tıklayın
- Sağ üst köşede bulunan ”+ Create New Portal” butonuna tıklayın
- Portal oluşturma formu açılır
2
Portal Bilgilerini Girme
Açılan form penceresinde aşağıdaki bilgileri doldurun:
İsim (Name) - Zorunlu
İsim (Name) - Zorunlu
- Portal için benzersiz bir tanımlayıcı isim girin
- Sadece harf, rakam ve tire (-) karakteri kullanılabilir
- Boşluk karakteri kullanılamaz
- Örnek:
partner-portal,internal-dev-portal
Görünen Ad (Display Name) - Zorunlu
Görünen Ad (Display Name) - Zorunlu
- Portal kullanıcı arayüzünde görünecek isim
- Türkçe ve İngilizce karakterler kullanılabilir
- Boşluk karakteri kullanılabilir
- Örnek:
Partner API Portal,İç Geliştirici Portalı
Bu isim portal ana sayfasında ve e-posta bildirimlerinde görünür.
Görünürlük Türü (Visibility Type) - Zorunlu
Görünürlük Türü (Visibility Type) - Zorunlu
Portal erişim seviyesini seçin:Public (Herkese Açık):
- Portal herkese açıktır
- Kayıt olan herkes portala erişebilir
- Genel kullanım için uygundur
- Portal sadece yetkili kullanıcılara açıktır
- Yönetici onayı gerektirir
- Kurumsal iç kullanım için uygundur
3
Portal Oluşturma
- Tüm zorunlu alanları doldurduğunuzdan emin olun
- “Create” butonuna tıklayın
- Sistem portalı oluşturur ve işlem tamamlanır
- Başarı mesajı gösterilir ve portal listesine yönlendirilirsiniz
Yeni Portal Oluşturma Formu
Portal oluşturulduktan sonra, portal için otomatik olarak benzersiz bir URL oluşturulur. Bu URL’yi portal ayarlarından özelleştirebilirsiniz.
Portal Detay Sayfasına Erişim
Portal detay sayfasına erişmek için aşağıdaki yöntemlerden birini kullanabilirsiniz:1
Yöntem 1: Liste Üzerinden
- Portal listesinde görüntülenen portallardan birine tıklayın
- Portal detay sayfası açılır
2
Yöntem 2: İşlem Menüsünden
- Portal listesinde ilgili portalın sağındaki üç nokta menüsüne tıklayın
- “View Details” veya “Edit” seçeneğini seçin
- Portal detay sayfası açılır
Portal Genel Bakış (Overview)
Portal detay sayfasında Overview (Genel Bakış) sekmesi varsayılan olarak açılır. Bu sayfada portalın tüm konfigürasyon ayarları ve istatistikleri görüntülenir.
Portal Genel Bakış Ekranı
Genel Bakış Bölümleri
Overview sayfasında aşağıdaki bilgi kartları ve bölümler yer alır:Temel Bilgiler
Temel Bilgiler
Portal Kimlik Bilgileri:
- Portal URL: Portala erişim için kullanılan tam URL adresi
- Portal ID: Sistem tarafından otomatik oluşturulan benzersiz tanımlayıcı
- Portal Durumu: Aktif veya Pasif durumu
- Oluşturulma Tarihi: Portalın oluşturulduğu tarih ve saat
- Son Güncelleme: Portalın son güncellendiği tarih ve saat
Portal URL’ini kopyalamak için URL yanındaki kopyalama ikonuna tıklayabilirsiniz.
Güvenlik ve Erişim Ayarları
Güvenlik ve Erişim Ayarları
Güvenlik Konfigürasyonları:
- Hesap Oluşturma: Geliştiricilerin kendi hesaplarını oluşturma izni (Aktif/Pasif)
- Otomatik Onay: Yeni hesapların otomatik onaylanması (Aktif/Pasif)
- API Abonelik Onayı: API’lere abonelik için otomatik onay (Aktif/Pasif)
- Credential Yönetimi: Kullanıcıların kendi API anahtarlarını yönetme izni (Aktif/Pasif)
- Organizasyon Yöneticisi İzinleri: Organizasyon yöneticilerinin hesap yönetimi izinleri
Bu ayarları değiştirmek için Portal Ayarları sayfasına gidin.
Dil ve Yerelleştirme
Dil ve Yerelleştirme
Çoklu Dil Ayarları:
- Varsayılan Dil: Portalın varsayılan dili (TR/EN)
- Türkçe Desteği: Türkçe dil seçeneğinin aktif olup olmadığı
- İngilizce Desteği: İngilizce dil seçeneğinin aktif olup olmadığı
- Çoklu Dil Modu: Her iki dil de aktifse otomatik olarak çoklu dil modu aktif olur
Çoklu dil modu aktif olduğunda, portal içeriği her iki dilde de görüntülenebilir.
Aktif Özellikler
Aktif Özellikler
Portal Özellikleri:
- How to Use Menüsü: “Nasıl Kullanılır” menüsünün aktif olup olmadığı
- Test Araçları (Try It Out): API test konsolunun aktif olup olmadığı
- Jira Entegrasyonu: Jira ticket oluşturma özelliğinin aktif olup olmadığı
- Analytics: Kullanım istatistikleri ve raporlama özelliğinin aktif olup olmadığı
- API Dokümantasyonu: API dokümantasyon görüntüleme özelliği
Özellikleri aktif/pasif yapmak için Portal Ayarları → Özellikler sekmesini kullanın.
İstatistikler ve Metrikler
İstatistikler ve Metrikler
Portal Kullanım İstatistikleri:
- Yayınlanmış API Sayısı: Portalda yayınlanan toplam API ürün sayısı
- Kayıtlı Geliştirici Sayısı: Portala kayıtlı toplam geliştirici/hesap sayısı
- Aktif Geliştirici Sayısı: Aktif durumda olan geliştirici sayısı
- Oluşturulan Uygulama Sayısı: Portaldaki toplam uygulama kayıt sayısı
- Toplam API Çağrı Sayısı: Portal üzerinden yapılan toplam API çağrı sayısı
- Son 30 Günlük Çağrı: Son 30 gün içinde yapılan API çağrı sayısı
Overview sayfasındaki ayarları değiştirmek için ilgili bölümlere tıklayarak Portal Ayarları sayfasına yönlendirilebilirsiniz. Detaylı bilgi için Portal Ayarları dokümanını inceleyebilirsiniz.
Portal Düzenleme
Portal bilgilerini düzenlemek için aşağıdaki adımları takip edin:1
Portal Detay Sayfasına Erişim
- Portal listesinden düzenlemek istediğiniz portala tıklayın
- Portal detay sayfası açılır
2
Düzenleme Butonuna Tıklama
- Sayfanın üst kısmında bulunan “Edit” veya “Configure” butonuna tıklayın
- Alternatif olarak, portal listesinde ilgili portalın sağındaki üç nokta menüsünden “Edit” seçeneğini seçebilirsiniz
3
Bilgileri Güncelleme
Açılan düzenleme formunda aşağıdaki bilgileri güncelleyebilirsiniz:
Görünen Ad (Display Name)
Görünen Ad (Display Name)
- Portalın görünen adını değiştirebilirsiniz
- Bu isim portal arayüzünde ve e-posta bildirimlerinde görünür
- İsim değişikliği anında yansır
Görünürlük Türü (Visibility Type)
Görünürlük Türü (Visibility Type)
- Portal erişim seviyesini değiştirebilirsiniz
- Public: Herkese açık
- Internal: Sadece yetkili kullanıcılara açık
Portal URL
Portal URL
- Portal URL’ini özelleştirebilirsiniz (eğer özelleştirme izni varsa)
- URL formatı:
https://your-domain.com/portal-name
URL değişikliği yapıldığında, eski URL’ye yapılan bağlantılar çalışmayabilir.
4
Değişiklikleri Kaydetme
- Yaptığınız değişiklikleri kontrol edin
- “Save” veya “Update” butonuna tıklayın
- Başarı mesajı gösterilir ve değişiklikler kaydedilir
Portal adı (Name) teknik bir tanımlayıcıdır ve oluşturulduktan sonra değiştirilemez. Sadece görünen ad (Display Name) güncellenebilir.
Portal Durum Yönetimi
Portalın aktif veya pasif durumunu yönetebilirsiniz. Pasif bir portal, kullanıcılar tarafından erişilemez ancak silinmez.Portalu Aktif/Pasif Yapma
1
Portal Detay Sayfasına Erişim
- Portal listesinden ilgili portala tıklayın
- Portal detay sayfası açılır
2
Durum Değiştirme
Portalı pasif yapmak için:
- Sayfanın üst kısmında bulunan “Deactivate” veya durum toggle butonuna tıklayın
- Onay dialogu açılır
- “Activate” butonuna tıklayın
- Onay dialogu açılır
3
Onay Verme
- Açılan onay dialogunda işlemi onaylayın
- “Yes” veya “Confirm” butonuna tıklayın
- Portal durumu güncellenir
Durum Değişikliğinin Etkileri
- Aktif Portal
- Pasif Portal
Aktif Portal Özellikleri:
- Kullanıcılar portala erişebilir
- API’ler görüntülenebilir ve kullanılabilir
- Yeni kullanıcı kayıtları kabul edilir
- E-posta bildirimleri gönderilir
- Analytics verileri toplanır
Portal Silme
Portalı kalıcı olarak silmek için aşağıdaki adımları takip edin:1
Portal Detay Sayfasına Erişim
- Portal listesinden silmek istediğiniz portala tıklayın
- Portal detay sayfası açılır
2
Danger Zone Bölümüne Git
- Sayfanın alt kısmında bulunan “Danger Zone” sekmesine tıklayın
- Kritik işlemler bu bölümde yer alır
3
Silme Butonuna Tıklama
- “Delete Portal” veya “Remove Portal” butonuna tıklayın
- Onay dialogu açılır
4
Portal Adını Onaylama
- Onay dialogunda portal adını yazmanız istenir
- Portal adını tam olarak girin (büyük/küçük harf duyarlı)
- Bu adım yanlışlıkla silmeyi önlemek içindir
5
Silme İşlemini Onaylama
- Portal adını doğru girdiğinizden emin olun
- “Yes, Delete” veya “Confirm Delete” butonuna tıklayın
- Portal kalıcı olarak silinir
- Portal listesine yönlendirilirsiniz
Silme İşleminin Etkileri
Portal silindiğinde aşağıdaki veriler kalıcı olarak silinir:| Veri Tipi | Açıklama |
|---|---|
| Portal Konfigürasyonu | Tüm portal ayarları ve konfigürasyonları |
| Kullanıcı Hesapları | Portala kayıtlı tüm geliştirici hesapları |
| API Ürünleri | Portalda yayınlanan tüm API ürünleri |
| Uygulama Kayıtları | Tüm uygulama kayıtları ve abonelikler |
| API Anahtarları | Tüm oluşturulmuş API anahtarları (Client ID/Secret) |
| İçerikler | Portal içerikleri, dokümantasyon sayfaları |
| İstatistikler | Tüm analytics verileri ve kullanım istatistikleri |
| Dosyalar | Portalda yüklenmiş tüm dosyalar |
Portal silmeden önce, önemli verileri yedeklemek veya farklı bir portala taşımak için zaman ayırmanız önerilir.
Portal Yönetimi
Portal oluşturduktan sonra aşağıdaki yönetim işlemlerini gerçekleştirebilirsiniz:Tema Özelleştirme
Portal görünümünü ve temasını özelleştirin
API Yönetimi
Portal üzerinde yayınlanacak API’leri yönetin
Kullanıcı Yönetimi
Geliştirici hesaplarını ve yetkilerini yönetin
İçerik Yönetimi
Portal içeriklerini düzenleyin
Güvenlik Ayarları
Erişim kontrolü ve güvenlik politikalarını yapılandırın
Analytics
Portal kullanım istatistiklerini görüntüleyin
Portal Ayarlarını Yapılandırma
Portal oluşturulduktan sonra, portalın düzgün çalışması için temel ayarları yapılandırmanız gerekir.Portal Ayarlarına Erişim
1
Portal Detay Sayfasına Git
- Portal listesinden ilgili portala tıklayın
- Portal detay sayfası açılır
2
Settings Sekmesine Git
- Sayfanın üst kısmında bulunan “Settings” veya “Configuration” sekmesine tıklayın
- Alternatif olarak, Overview sayfasındaki ilgili bölümlere tıklayarak da ayarlara erişebilirsiniz
Temel Ayarlar
Portal ayarları aşağıdaki kategorilerde düzenlenmiştir:Genel Ayarlar
Genel Ayarlar
Portal Temel Bilgileri:
- Portal adı ve görünen ad
- Portal URL yapılandırması
- Varsayılan dil ayarı
- Çoklu dil desteği (TR/EN)
- Portal açıklaması
Detaylı bilgi için Portal Ayarları - Genel bölümünü inceleyin.
E-posta Ayarları
E-posta Ayarları
E-posta Konfigürasyonu:
- E-posta sunucu ayarları
- Gönderen e-posta adresi
- E-posta şablonları (kayıt, onay, şifre sıfırlama vb.)
- E-posta bildirim ayarları
Detaylı bilgi için Portal Ayarları - E-posta bölümünü inceleyin.
Güvenlik Ayarları
Güvenlik Ayarları
Güvenlik Konfigürasyonları:
- Hesap oluşturma izinleri
- Otomatik onay ayarları
- API abonelik onay süreçleri
- Credential yönetim izinleri
- Organizasyon yöneticisi yetkileri
Detaylı bilgi için Portal Ayarları - Güvenlik bölümünü inceleyin.
Özellik Ayarları
Özellik Ayarları
Portal Özellikleri:
- How to Use menüsü
- Test araçları (Try It Out)
- Jira entegrasyonu
- Analytics özelliği
- Performans metrikleri
Detaylı bilgi için Portal Ayarları - Özellikler bölümünü inceleyin.
Yasal Ayarlar
Yasal Ayarlar
Yasal Düzenlemeler:
- Kullanım koşulları (Terms of Service)
- Gizlilik politikası (Privacy Policy)
- Yasal dosya yükleme
Detaylı bilgi için Portal Ayarları - Yasal bölümünü inceleyin.
Portal ayarlarını değiştirdikten sonra mutlaka “Save” butonuna tıklayarak değişiklikleri kaydedin. Kaydedilmeyen değişiklikler kaybolur.
Portal Erişimi ve URL Yönetimi
Portal URL’sine Erişim
Her portal için otomatik olarak benzersiz bir URL oluşturulur. Bu URL’yi kullanarak portala erişebilirsiniz.1
Portal URL'sini Bulma
- Portal detay sayfasında Overview sekmesine gidin
- “Portal URL” bölümünde tam URL adresi görüntülenir
- URL yanındaki kopyalama ikonuna tıklayarak URL’yi kopyalayabilirsiniz
2
Portala Erişim
- Kopyaladığınız URL’yi tarayıcı adres çubuğuna yapıştırın
- Enter tuşuna basın
- Portal ana sayfası açılır
Portal URL Formatı
Portal URL’leri aşağıdaki formatta oluşturulur:- Portal adı:
partner-portal - Portal URL:
https://api.company.com/portal/partner-portal
Portal URL’ini özelleştirmek için Portal Ayarları → Genel Ayarlar bölümünden “Custom Portal URL” alanını kullanabilirsiniz.
Portal Erişim Kontrolü
Portal erişimi, portalın görünürlük tipine göre kontrol edilir:- Public Portal
- Internal Portal
Herkese Açık Portal:
- Herkes portala erişebilir
- Kayıt olmak için “Sign Up” butonuna tıklayabilir
- Portal ana sayfası ve API kataloğu herkese açıktır
- API’leri görüntüleyebilir ancak kullanmak için kayıt olması gerekir
Yönetici Yetkileri
Portal yöneticileri aşağıdaki işlemleri gerçekleştirebilir:| Yetki | Açıklama |
|---|---|
| Portal Ayarları | Portal genel ayarlarını görüntüleme ve düzenleme |
| Kullanıcı Yönetimi | Geliştirici hesaplarını görüntüleme, onaylama, reddetme |
| API Yönetimi | API ürünlerini görüntüleme, yayınlama, yayından kaldırma |
| İçerik Yönetimi | Portal içeriklerini düzenleme, dokümantasyon ekleme |
| Analytics | Portal kullanım istatistiklerini görüntüleme |
| Tema Özelleştirme | Portal görünümünü ve temasını özelleştirme |
Portal İçerik Yönetimi
Portal içeriklerini yönetmek için aşağıdaki adımları takip edin:Ana Sayfa İçeriği
1
Portal Appearance Sayfasına Git
- Portal detay sayfasında “Appearance” veya “Content” sekmesine gidin
- Alternatif olarak, Portal Ayarları → Portal Appearance bölümüne gidebilirsiniz
2
Ana Sayfa İçeriğini Düzenleme
- “Homepage Content” bölümüne gidin
- HTML veya Markdown formatında içerik ekleyebilirsiniz
- Görsel, bağlantı ve formatlama ekleyebilirsiniz
3
İçeriği Kaydetme
- Değişiklikleri yaptıktan sonra “Save” butonuna tıklayın
- İçerik anında portal ana sayfasında görüntülenir
Dokümantasyon Sayfaları
Portal için özel dokümantasyon sayfaları oluşturabilirsiniz:1
Dokümantasyon Bölümüne Git
- Portal detay sayfasında “Documentation” sekmesine gidin
- Mevcut dokümantasyon sayfaları listelenir
2
Yeni Sayfa Ekleme
- ”+ Add Page” butonuna tıklayın
- Sayfa oluşturma formu açılır
3
Sayfa Bilgilerini Doldurma
- Sayfa Adı: Dokümantasyon sayfasının adı
- Slug: URL’de kullanılacak kısa ad (otomatik oluşturulur)
- İçerik: Markdown veya HTML formatında içerik
- Sıralama: Sayfanın menüdeki sırası
4
Sayfayı Kaydetme
- “Save” butonuna tıklayın
- Sayfa portal menüsüne eklenir
Portal Görünüm Özelleştirme
Portalın görünümünü ve temasını özelleştirebilirsiniz:Tema Ayarları
1
Portal Appearance Sayfasına Git
- Portal detay sayfasında “Appearance” sekmesine gidin
- Tema özelleştirme seçenekleri görüntülenir
2
Logo Yükleme
- “Logo” bölümüne gidin
- “Upload Logo” butonuna tıklayın
- Logo dosyasını seçin (PNG, JPG, SVG formatları desteklenir)
- Logo otomatik olarak yüklenir ve önizleme gösterilir
3
Renk Şeması Özelleştirme
- “Color Scheme” bölümüne gidin
- Aşağıdaki renkleri özelleştirebilirsiniz:
- Primary Color: Ana renk (butonlar, bağlantılar)
- Secondary Color: İkincil renk (vurgular)
- Background Color: Arka plan rengi
- Text Color: Metin rengi
- Renk seçiciyi kullanarak renkleri seçin
- Değişiklikler anında önizlenir
4
Font Ayarları
- “Typography” bölümüne gidin
- Font ailesini seçin (ör: Arial, Roboto, Open Sans)
- Font boyutlarını ayarlayın
- Başlık ve metin fontlarını özelleştirin
5
Değişiklikleri Kaydetme
- Tüm değişiklikleri yaptıktan sonra “Save” butonuna tıklayın
- Tema değişiklikleri anında portala yansır
Tema özelleştirme hakkında detaylı bilgi için Tema Özelleştirme dokümanını inceleyebilirsiniz.
Sonraki Adımlar
Portal oluşturma ve temel yapılandırma işlemlerini tamamladıktan sonra:1
Portal Ayarlarını Yapılandırın
- Genel ayarları (dil, URL, e-posta) yapılandırın
- Güvenlik ayarlarını (hesap oluşturma, otomatik onay) belirleyin
- Özellik ayarlarını (Try It, Analytics, Jira) aktif edin
- Yasal dosyaları (Terms of Service, Privacy Policy) yükleyin
2
Portal Görünümünü Özelleştirin
- Logo ve renk şemasını ayarlayın
- Ana sayfa içeriğini hazırlayın
- Portal temasını özelleştirin
3
API'leri Yayınlayın
- Portal üzerinde yayınlanacak API ürünlerini oluşturun
- API dokümantasyonlarını hazırlayın
- Fiyatlandırma planlarını yapılandırın
- API’leri yayınlayın (Publish)
4
Kullanıcı Yönetimini Yapılandırın
- Portal yöneticilerini atayın
- Geliştirici hesaplarını oluşturun veya kayıt sürecini başlatın
- Kullanıcı rollerini ve yetkilerini belirleyin
5
İçerikleri Hazırlayın
- Portal ana sayfası içeriğini hazırlayın
- Dokümantasyon sayfalarını oluşturun
- “How to Use” sayfasını düzenleyin
- Yardım ve destek içeriklerini ekleyin
6
Portali Test Edin
- Portala farklı kullanıcı rollerinde giriş yapın
- API’leri test edin
- E-posta bildirimlerini kontrol edin
- Tüm özelliklerin çalıştığından emin olun
7
Portali Yayınlayın
- Tüm yapılandırmaları tamamladıktan sonra portali aktif edin
- Kullanıcılara portal URL’sini paylaşın
- Geliştiricileri portala davet edin
Sık Sorulan Sorular
Birden fazla portal oluşturabilir miyim?
Birden fazla portal oluşturabilir miyim?
Evet, istediğiniz kadar portal oluşturabilirsiniz. Her portal tamamen bağımsız çalışır ve kendi ayarlarına, kullanıcılarına ve API’lerine sahiptir.Kullanım Senaryoları:
- Farklı departmanlar için ayrı portallar
- Partner şirketler için özel portallar
- Test ve production ortamları için ayrı portallar
- Farklı bölgeler için yerelleştirilmiş portallar
Portal oluşturulduktan sonra adını değiştirebilir miyim?
Portal oluşturulduktan sonra adını değiştirebilir miyim?
Portal adı (Name) teknik bir tanımlayıcıdır ve oluşturulduktan sonra değiştirilemez. Ancak görünen ad (Display Name) istediğiniz zaman değiştirilebilir.Değiştirilebilen:
- Görünen Ad (Display Name)
- Portal URL (özelleştirme izni varsa)
- Portal açıklaması
- Portal adı (Name) - teknik tanımlayıcı
Pasif bir portalı tekrar aktif yapabilir miyim?
Pasif bir portalı tekrar aktif yapabilir miyim?
Evet, pasif bir portalı istediğiniz zaman tekrar aktif yapabilirsiniz. Portal pasif yapıldığında:
- Tüm ayarlar ve içerikler korunur
- Kullanıcı hesapları silinmez
- API’ler ve dokümantasyonlar korunur
- Portal tekrar aktif yapıldığında her şey eskisi gibi çalışır
Portal silindikten sonra veriler geri getirilebilir mi?
Portal silindikten sonra veriler geri getirilebilir mi?
Hayır, portal silme işlemi geri alınamaz. Silinen portal ve tüm verileri (kullanıcılar, API’ler, içerikler, istatistikler) kalıcı olarak silinir.Öneriler:
- Portal silmeden önce önemli verileri yedekleyin
- Portalı pasif yaparak geçici olarak devre dışı bırakın
- Silme işlemini yapmadan önce tüm etkileri değerlendirin
Bir portalı başka bir portala kopyalayabilir miyim?
Bir portalı başka bir portala kopyalayabilir miyim?
Şu anda portal kopyalama özelliği bulunmamaktadır. Ancak aşağıdaki yöntemlerle benzer bir portal oluşturabilirsiniz:Manuel Kopyalama:
- Yeni bir portal oluşturun
- Ayarları manuel olarak yapılandırın
- API’leri tekrar yayınlayın
- İçerikleri kopyalayın
Portal kopyalama özelliği gelecek sürümlerde eklenebilir.
Portal URL'sini özelleştirebilir miyim?
Portal URL'sini özelleştirebilir miyim?
Evet, portal URL’sini özelleştirebilirsiniz. Portal Ayarları → Genel Ayarlar bölümünden “Custom Portal URL” alanını kullanarak özel bir URL belirleyebilirsiniz.Önemli Notlar:
- URL değişikliği yapıldığında eski URL’ye yapılan bağlantılar çalışmayabilir
- URL formatı geçerli bir domain formatında olmalıdır
- URL değişikliği DNS ayarlarını da gerektirebilir
Portal yöneticisi olarak atanan kullanıcılar ne yapabilir?
Portal yöneticisi olarak atanan kullanıcılar ne yapabilir?
Portal yöneticileri aşağıdaki işlemleri gerçekleştirebilir:Yapabilecekleri:
- Portal ayarlarını görüntüleme ve düzenleme
- Kullanıcı hesaplarını yönetme (onaylama, reddetme)
- API ürünlerini yönetme (yayınlama, yayından kaldırma)
- Portal içeriklerini düzenleme
- Analytics verilerini görüntüleme
- Tema özelleştirme
- Portalı silme
- Diğer yöneticileri kaldırma
- Sistem seviyesi ayarları değiştirme
Public ve Internal portal arasındaki fark nedir?
Public ve Internal portal arasındaki fark nedir?
Public Portal (Herkese Açık):
- Herkes portala erişebilir
- Kayıt olma butonu görünür
- Herkes kayıt olabilir (otomatik veya manuel onay ile)
- Genel kullanım için uygundur
- Sadece yetkili kullanıcılar erişebilir
- Kayıt olma butonu görünmez veya devre dışıdır
- Kullanıcılar yönetici tarafından manuel olarak eklenir
- Kurumsal iç kullanım için uygundur