Portal Settings (API Portal Ayarları), portal’ın temel ayarlarını, davranışlarını ve içerik sayfalarını kontrol eder. Bu sayfada genel ayarlar, e-posta bildirimleri, güvenlik ayarları, özellikler, yasal düzenlemeler, SEO ayarları ve portal içerik yönetimi (Ana Sayfa, Footer, How It Works, Pending Page, Navigation Menu) yapılır.Portal Appearance (Görünüm ve Tema) ise görsel öğeleri (logo, renkler, font) kontrol eder.
Genel Ayarlar
Portal’ın temel konfigürasyon ayarları bu bölümde yapılır.
Portal Ayarları Genel
| Alan | Açıklama | Portal Arayüzündeki Kullanımı |
|---|---|---|
| Ad | Sistem içinde API Portal’ı tanımlamak için kullanılır. Teknik tanımlayıcı olarak kullanılır. Sistem loglarında ve raporlarda portal tanımlanır. Zorunlu, benzersiz alandır. Örn: <şirketAdı>-developer-portal | Portal içinde teknik kimlik; doğrudan arayüzde görülmez fakat loglar ve raporlarda bu değer yer alır. |
| Görünen Ad (Display Name) | Portal’a daha anlaşılır ve kullanıcı dostu bir isim verilir. Pazarlama ve iletişimde kullanılır. Kullanıcıların portal’ı daha kolay hatırlamasını sağlanılır. Opsiyonel, kullanıcı dostu. Örn: <şirketAdı> API Developer Portal | Portal üst menüsünde ve e-posta şablonlarında görünen başlık olarak kullanılır. |
| Size Özel Portal URL’si (Custom Portal URL) | API Portal’a erişim adresi olarak kullanılır. E-posta bildirimlerindeki linklerde, API key aktivasyon linklerinde, Tüm portal URL’lerinin base adresi olarak belirlenir, Kurumsal domain kullanılır. Tam URL formatında olmalı (http:// veya https://) Örnek: https://apiportal.company.com | Tüm portal linklerinin temel adresi; kayıt/onay mailindeki butonlar, “Forgot Password” gibi yönlendirmeler bu URL’ye göre oluşturulur. |
| Varsayılan Dil (Default Language) | Kullanıcı ilk kez API Portal’a girdiğinde varsayılan dil olarak gösterilir. Sistemde tanımlı tüm dillerden birini seçebilirsiniz (TR, EN, DE, FR, ES, vb.). Portal, seçilen dilde açılır ve kullanıcı dil değiştirici (language switcher) ile istediği dile geçiş yapabilir. | Portal girişinde otomatik dil seçimi; dil switcher bileşeninde hangi seçeneklerin listeleneceğini belirler. |
| Dil Seçenekleri (Language Options) | Portal’da kullanıcılara sunulacak dilleri belirler. Sistemde tanımlı tüm dillerden istediğiniz kadarını seçebilirsiniz (Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, vb.). Her dil için ayrı ayrı etkinleştirme yapılabilir. Etkinleştirilen diller, portal’da dil seçici (language switcher) olarak görünür ve kullanıcılar bu diller arasında geçiş yapabilir. Çoklu dil özelliğini kontrol eder. | Etkinleştirilen dillerin içeriklerinin gösterilip gösterilmeyeceğini belirler. Birden fazla dil etkinleştirildiğinde, portal çok dilli (multilanguage) moda geçer. |
| Tanım | Sistem yöneticileri için açıklayıcı bilgi olarak tanımlanır. Portal’ın amacını ve kapsamını açıklamak için kullanılır. Diğer yöneticiler için bilgi notu bırakılır. Örn: Bu portal, dış partner şirketlerimizin API’lerimize erişmesi için oluşturulmuştur. Müşteri verilerine erişim gerektiren tüm API’ler burada yayınlanmaktadır. Portal, GDPR ve ISO 27001 standartlarına uygun olarak yapılandırılmıştır. | Yalnızca yönetsel not; Portal kullanıcı arayüzünde gösterilmez. |
Portal ayarlarında birden fazla dil seçeneği etkinleştirildiğinde, sistem otomatik olarak Çoklu Dil (Multilanguage) moduna geçer.Eğer Çoklu Dil özelliği Portal Ayarlarından aktif hale getirilmişse, Arayüz ve form alanları etkinleştirilen tüm dillerde görüntülenir ve her dil için ayrı veri girişi yapılabilir. Sistem, sadece Türkçe ve İngilizce ile sınırlı değildir; sistemde tanımlı tüm dilleri destekler (Almanca, Fransızca, İspanyolca, İtalyanca, vb.).Önemli: Her dil için içerik girişi yapılması gerekmektedir. Etkinleştirilen bir dil için içerik girilmezse, o dildeki sayfalar boş görünebilir.
E-Posta Bildirimleri
Portal’dan kullanıcılara gönderilen otomatik e-postalar bu sekmede yapılandırılır. Kullanıcı kayıt, onay, red, API abonelik gibi işlemlerde otomatik e-postalar gönderilir.
E-posta Ayarları
| Alan | Açıklama |
|---|---|
| E-mail server | API Portalı’nın e-posta göndermek için kullandığı e-posta sunucusunun adresi. Önceden tanımlanmış e-posta sunucu ayarları seçilir. Connection Config Email listesinden seçim yapılır. Bu ayar, SMTP sunucu bilgilerini içerir. |
| Görünen Ad | E-posta iletilerinin hangi isimle gönderileceğini belirler. Kullanıcılar bu ismi görerek e-postanın nereden geldiğini anlar |
| Gönderen E-postası | API Portalı’ndan gönderilen e-postaların hangi adres üzerinden gönderileceğini belirtir. Örneğin, “[email protected]”. Bu adresten e-postalar gönderilir. |
| Yanıtlama E-postası | Kullanıcı “Yanıtla” butonuna bastığında gidecek adres belirtilir. Örnek: “[email protected]” Gerçek bir destek e-postası olmalıdır. |
E-posta Şablonları
Portal’dan otomatik olarak gönderilen 8 farklı e-posta tipi vardır. Her birini ayrı ayrı özelleştirilebilir.E-posta Adresinizi Onaylayın
E-posta Adresinizi Onaylayın
Ne Zaman Gönderilir:
- Yeni bir kullanıcı portal’a kayıt olduğunda
- Kullanıcının e-posta adresini doğrulaması gerektiğinde
1
Kullanıcı Kayıt Olur
Portal’da “Register” butonuna tıklar, Kayıt formunu doldurur, “Sign Up” butonuna basar
2
Sistem E-posta Gönderir
“Confirm Email Address” e-postası otomatik gönderilir, E-posta, kullanıcının girdiği adrese ulaşır, Özel onay linki içerir
3
Kullanıcı E-postayı Alır
Subject: Ayarladığınız konu, Title: Ayarladığınız başlık, Body: Ayarladığınız içerik, Buton: Ayarladığınız buton metni (örn: “E-postamı Onayla”)
4
Kullanıcı Linke Tıklar
E-postadaki onay linkine/butonuna tıklar, Portal’a yönlendirilir, E-posta adresi doğrulanır
5
Sonraki Adım (Ayara Bağlı)
[Auto Approve Account = AKTIF ise] Hesap otomatik onaylanır, Welcome e-postası gönderilir, Kullanıcı portal’a girebilir[Auto Approve Account = PASIF ise] Yönetici onayı beklenir, “Hesabınız inceleniyor” mesajı gösterilir, Yönetici onayladıktan sonra Welcome e-postası gönderilir
Hoş Geldiniz
Hoş Geldiniz
Ne Zaman Gönderilir:
- Kullanıcının hesabı onaylandığında
- Yönetici tarafından manuel onay sonrası veya otomatik onay durumunda
1
Kullanıcı E-postasını Onaylamıştır
Kullanıcı “Confirm Email Address” mailindeki linke tıklamış, E-posta adresi doğrulanmış
2
Hesap Onaylanır (İki Senaryo)
[SENARYO 1: Auto Approve Account = AKTIF] Hesap otomatik olarak onaylanır, “Welcome” e-postası anında gönderilir[SENARYO 2: Auto Approve Account = PASIF] Yönetici bildirim alır, Yönetici Manager’a girer, Portal Management → Developer Accounts bölümüne gider, Bekleyen kullanıcıyı görür, [Approve] butonuna tıklar, “Welcome” e-postası gönderilir
3
Kullanıcı E-postayı Alır
Subject: Ayarladığınız konu, Title: Ayarladığınız başlık, Body: Ayarladığınız içerik, Buton: Ayarladığınız buton metni (örn: “Portal’a Git”)
4
Kullanıcı Portal'a Erişebilir
Artık portal’a giriş yapabilir, API’leri inceleyebilir, Uygulama kaydı yapabilir
Şifre Sıfırlama
Şifre Sıfırlama
Ne Zaman Gönderilir:
- Kullanıcı “Şifremi Unuttum” butonuna tıkladığında
- Yönetici kullanıcı için şifre sıfırlama işlemi başlattığında
1
Kullanıcı Şifresini Unutur
Portal giriş sayfasında “Forgot Password?” linkine tıklar, E-posta adresini girer, “Reset Password” butonuna basar
2
Sistem E-posta Gönderir
“Reset Password” e-postası otomatik gönderilir, E-posta, özel sıfırlama linki içerir, Link belirli süre geçerlidir (örn: 24 saat)
3
Kullanıcı E-postayı Alır
Subject: Ayarladığınız konu, Title: Ayarladığınız başlık, Body: Ayarladığınız içerik, Buton: Ayarladığınız buton metni (örn: “Şifremi Sıfırla”)
4
Kullanıcı Linke Tıklar
E-postadaki sıfırlama linkine/butonuna tıklar, Portal’da şifre sıfırlama sayfasına yönlendirilir, Yeni şifresini girer (2 kez)
5
Şifre Güncellenir
Yeni şifre kaydedilir, “Şifreniz başarıyla güncellendi” mesajı, Kullanıcı yeni şifresiyle giriş yapabilir
Hesap Erişimi Reddedildi
Hesap Erişimi Reddedildi
Ne Zaman Gönderilir:
- Yönetici kullanıcının kayıt talebini reddettiğinde
- Manuel onay sürecinde kullanıcı uygun görülmediğinde
1
Kullanıcı Kayıt Olmuş ve E-posta Onaylamıştır
Kullanıcı portal’a kayıt olmuş, E-posta adresini doğrulamış, Manuel onay bekliyor (Auto Approve Account = PASIF)
2
Yönetici Talebi İnceler
Yönetici Manager’a girer, Portal Management → Developer Accounts bölümüne gider, “Pending Approval” filtresi ile bekleyen kullanıcıları görür, İlgili kullanıcıyı inceler
3
Yönetici Talebi Reddeder
[Reject] butonuna tıklar, Red nedeni girerse (opsiyonel), Onaylar
4
Sistem İşlemi Gerçekleştirir
Kullanıcı hesabı pasif edilir veya silinir, “Account Access Rejected” e-postası gönderilir
5
Kullanıcı E-postayı Alır
Subject: Ayarladığınız konu, Title: Ayarladığınız başlık, Body: Ayarladığınız içerik
6
Kullanıcı Portal'a Erişemez
Giriş yapmaya çalışırsa hata alır, “Your account is not active” mesajı görür
Hesap Erişimi İptal Edildi
Hesap Erişimi İptal Edildi
Ne Zaman Gönderilir:
- Daha önce aktif olan bir kullanıcının erişimi iptal edildiğinde
- Yönetici tarafından kullanıcı devre dışı bırakıldığında
- Güvenlik veya politika ihlali durumunda
1
Kullanıcı Aktif Bir Hesaba Sahiptir
Kullanıcı daha önce onaylanmış, Portal’ı aktif olarak kullanıyor, API’lere erişimi var
2
İptal Nedeni Oluşur
Güvenlik ihlali tespit edilir, Kullanım politikası ihlal edilir, Sözleşme/üyelik sona erer, Manuel yönetici kararı
3
Yönetici Erişimi İptal Eder
Yönetici Manager’a girer, Portal Management → Developer Accounts bölümüne gider, İlgili kullanıcıyı bulur, [Revoke Access] seçer, İptal nedenini girer (opsiyonel), Onaylar
4
Sistem İşlemi Gerçekleştirir
Kullanıcı hesabı anında devre dışı bırakılır, Tüm aktif oturumlar kapatılır, API key’ler pasif edilir, “Account Access Rejected” e-postası gönderilir
5
Kullanıcı E-postayı Alır
Subject: Ayarladığınız konu, Title: Ayarladığınız başlık, Body: Ayarladığınız içerik
6
Kullanıcı Etkileri
Hemen çıkış yapılır (aktif oturum varsa), Tekrar giriş yapamaz, API çağrıları 401 Unauthorized döner, Tüm uygulama kayıtları pasif olur
Uygulama Kaydı Onaylandı
Uygulama Kaydı Onaylandı
Ne Zaman Gönderilir:
- Kullanıcının bir API’ye app kaydı talebi onaylandığında
- Yönetici manuel onay verdiğinde veya otomatik onay durumunda
1
Kullanıcı API'ye Abone Olmak İster
Kullanıcı portal’a giriş yapar, API katalogunu inceler, İlgili API’yi seçer, “Subscribe” veya “Register App” butonuna tıklar
2
Uygulama Bilgilerini Girer
Application Name girer, Description ekler, Plan seçer (Free, Basic, Premium vb.), “Submit” butonuna basar
3
Sistem Talebi İşler (İki Senaryo)
[SENARYO 1: Auto Approve API Subscribe = AKTIF] Kayıt otomatik onaylanır, API key’ler anında oluşturulur, “App Registration Approved” e-postası gönderilir[SENARYO 2: Auto Approve API Subscribe = PASIF] Yönetici bildirim alır, Yönetici Manager’a girer, API Management → Subscriptions bölümüne gider, “Pending Approval” filtresi ile bekleyen talepleri görür, İlgili talebi inceler, [Approve] butonuna tıklar, API key’ler oluşturulur, “App Registration Approved” e-postası gönderilir
4
Kullanıcı E-postayı Alır
Subject: Ayarladığınız konu, Title: Ayarladığınız başlık, Body: Ayarladığınız içerik (değişkenlerle zenginleştirilmiş), Buton: Ayarladığınız buton metni (örn: “API Dokümantasyonu”)
5
Kullanıcı API'yi Kullanmaya Başlar
Portal’da “My Apps” bölümüne gider, API key’lerini görür (Client ID, Secret), API dokümantasyonunu okur, İlk API çağrısını yapar, Test eder ve üretim ortamına alır
Uygulama Kaydı Reddedildi
Uygulama Kaydı Reddedildi
Ne Zaman Gönderilir:
- Kullanıcının API’ye app kaydı talebi reddedildiğinde
- Yönetici talebi uygun görmediğinde
1
Kullanıcı API'ye Abone Olma Talebi Yapmıştır
Kullanıcı API’ye subscribe olmuş, Uygulama bilgilerini girmiş, Manuel onay bekliyor (Auto Approve API Subscribe = PASIF)
2
Yönetici Talebi İnceler
Yönetici Manager’a girer, API Management → Subscriptions bölümüne gider, “Pending Approval” filtresiyle bekleyen talepleri görür
3
Yönetici Talebi Reddeder
[Reject] seçer, Red nedeni girer (opsiyonel, kullanıcıya gösterilmez), Onaylar
4
Sistem İşlemi Gerçekleştirir
Subscription talebi reddedildi olarak işaretlenir, API key’ler oluşturulmaz, “App Registration Rejected” e-postası gönderilir
5
Kullanıcı E-postayı Alır
Subject: Ayarladığınız konu, Title: Ayarladığınız başlık, Body: Ayarladığınız içerik, Buton: Giriş Yap
6
Kullanıcı Seçenekleri
Portal’da talebin reddedildiğini görür, Farklı bir plan ile tekrar deneyebilir, Destek ile iletişime geçebilir, Başka bir API’ye subscribe olabilir
Uygulama Kaydı İptal Edildi
Uygulama Kaydı İptal Edildi
Ne Zaman Gönderilir:
- Daha önce onaylanmış bir app kaydı iptal edildiğinde
- API kullanım politikası ihlali durumunda
- Yönetici tarafından erişim kaldırıldığında
1
Kullanıcı Aktif Bir Subscription'a Sahiptir
Kullanıcının app kaydı daha önce onaylanmış, API’yi aktif olarak kullanıyor, API key’leri çalışıyor
2
İptal Nedeni Oluşur
API kullanım politikası ihlali, Rate limit aşımları (sürekli), Ödeme sorunları (ücretli planlarda), Güvenlik ihlali tespit edilir, Kötüye kullanım (abuse) tespit edilir, Sözleşme sonlandırması, Manuel yönetici kararı
3
Yönetici Subscription'ı İptal Eder
Yönetici Manager’a girer, API Management → Subscriptions bölümüne gider, Active subscriptions listesinde ilgili subscription’ı bulur, [Revoke] seçer, İptal nedenini girer (opsiyonel), Onaylar
4
Sistem İşlemi Gerçekleştirir
Subscription anında iptal edilir, Tüm API key’ler devre dışı bırakılır, Rate limiter key’leri temizlenir, “App Registration Revoked” e-postası gönderilir
5
Kullanıcı E-postayı Alır
Subject: Ayarladığınız konu, Title: Ayarladığınız başlık, Body: Ayarladığınız içerik, Buton: Giriş Yap
6
Kullanıcı ve API Etkileri
O andan itibaren API çağrıları başarısız olur, HTTP 401 Unauthorized veya 403 Forbidden döner, Kullanıcı portal’da “Revoked” statusünü görür, Application sayfasında “Access Revoked” uyarısı
E-posta adresini onayla, Hoş Geldiniz, Hesap Erişimi Reddedildi, Hesap Erişimi İptal Edildi, Uygulama Kaydı onaylandı, Uygulama kaydı Reddedildi, Uygulama Kaydı İptal Edildi ve Şifre Sıfırlama mailleri için aşağıdaki görselde bulunan template kullanılmalıdır.
E-posta Şablonu
{{developer_fullname}}
- E-posta şablonunda {{developer_fullname}} kullanılırsa → Bildirimi alacak olan kullanıcının adı otomatik olarak o yere yazılır. Bu sayede gönderilen e-postalarda kişiye özel bir hitap sağlanmış olur
{{api_name}} - API ürün adı
{{application_name}} - Geliştiricinin uygulama adı
- E-posta şablonunda {{api_name}} kullanılırsa → Bildirimin ilgili olduğu API ürününün adı otomatik olarak o yere yazılır.
- E-posta şablonunda {{application_name}} kullanılırsa → Bildirimin ilgili olduğu uygulamanın adı otomatik olarak o yere yazılır.
| Alan | Açıklama |
|---|---|
| E-posta bildirimi aktif | E-posta bildiriminin aktif olup olmadığını belirler. Eğer aktifse, kullanıcıya e-posta gönderimi yapılır. Her bir mail için bu ayar özelleştirilebilir. |
| Konu | E-postanın konu satırında görünecek metni belirtir. Genellikle e-posta içeriğini özetleyen bir başlık olur. |
| Başlık | E-posta içeriğinin başlığını belirtir. Kullanıcıya e-postada görünen başlık metnidir. |
| İçerik | E-posta içeriği. Kullanıcıya gönderilecek mesajın detaylı metnini içerir. E-posta şablonlarında yer tutucularla (örneğin, {{developer_fullname}}) kişiselleştirilebilir. |
| Buton etiketi | E-posta içeriğinde bulunan butonun üzerinde görünecek metni belirtir. Kullanıcılar bu butona tıklayarak işlem yaparlar. Örneğin, “Confirm your email address” gibi. |
Güvenlik
API Developer Portal tarafında kullanılacak olan gizlilik ayarları, bu ekran üzerinden yönetilir.
Güvenlik Ayarları
| Alan | Açıklama | Portal Arayüzündeki Kullanımı |
|---|---|---|
| Geliştiricilerin kendi hesaplarını oluşturmalarını etkinleştirin (Activate developers to create their own accounts) | Security sekmesi → Enable Account Register. Portal’a yeni kullanıcı kaydını açmak veya kapatmak, Self-service kayıt özelliğini kontrol etmek amamcı ile kullanılır. Aktif olması durumunda Kullanıcılar portal’a kendi kendilerine kayıt olabilir, “Kayıt Ol” butonu görünür, Kayıt formu erişilebilir. | Portal giriş sayfasındaki “Sign Up/Register” butonunun görünürlüğünü belirler; pasifse self-signup kapalıdır. |
| Hesapları/Geliştiricileri Otomatik Onaylayın (Auto Approve Account/Developers) | Security sekmesi → Auto Approve Account. Kullanıcı onay sürecini otomatikleştirmek veya manuel hale getirmek, güvenlik seviyesini ayarlamak, erişim kontrolü sağlamak amacı ile kullanılır. Aktif olması durumunda kullanıcı kayıt olduğunda otomatik olarak onaylanır, E-posta onayından sonra hemen portal’a girebilir, Yönetici müdahalesine gerek yok, Welcome e-postası otomatik gönderilir. | Kayıt sonrası e-posta onaylayan kullanıcıların otomatik aktif olup olmayacağını belirler; pasifse Manager’dan manuel onay gerekir. |
| Kurum Yöneticisinin Kendi Hesaplarını Yönetmesine İzin Verin (Allow Organization Administrator to Manage their own Accounts) | Security sekmesi → Organization Manager Account Manage. Account/Developer menüsü üzerinden yeni kayıt oluştururken Organization Manager rolü atama imkanının olup olmamasını yönetir. Bu atama, hesap/geliştirici’nin API Portal tarafında kendi hesap/geliştirici oluşturulmasına imkan verir. Aktif olması durumunda sadece portal yöneticileri (admin) kullanıcı yönetimi yapabilir, organizasyon yöneticileri sadece kendi hesaplarını görebilir, merkezi kontrol sağlanır. | Organizasyon yöneticilerinin Portal içinde kullanıcı/hesap yönetip yönetemeyeceğini kontrol eder (Portal → Accounts ekranındaki yetkiler etkilenir). |
| Hesapların/Geliştiricilerin API’lere Abone Olmasına Otomatik İzin Verin (Auto allow accounts to subscribe to APIs) | Security sekmesi → Auto Approve API Subscribe. Bir geliştirici veya hesap API portalına kaydolduğunda, API’lere otomatik olarak abonelik izni verilir. Yani manuel olarak bir yönetici tarafından onaylanmasına gerek kalmaz. Aktif olması durumunda kullanıcı bir API’ye app kaydı yaptığında otomatik olarak onaylanır, API key’ler hemen oluşturulur ve aktif olur, kullanıcı anında API’yi kullanmaya başlayabilir, app Registration Approved e-postası otomatik gönderilir. | Kullanıcı Subscribe/Register App yaptığında planın otomatik onaylanıp API key’lerin hemen tanımlanmasını sağlar; pasifte Manager’da manuel onay akışı çalışır. |
| Hesapların Kendi Kimlik Bilgilerini Yönetmesine İzin Ver (Allow Accounts to Manage their own Credentials) | Security sekmesi → Enable Credential Manage. Kullanıcılara kendi API key’lerini yönetme izni vermek veya vermemek, güvenlik politikası gereği credential yönetimini sınırlandırmak amacı ile kullanılır. Aktif olması durumunda kullanıcılar kendi API key’lerini görebilir, yeni credential oluşturabilir, mevcut credential’ları silebilir veya yenileyebilir, API secret’larını görebilir. | Portal’daki My Apps bölümünde geliştiricilerin client ID/secret üretme, yeniden oluşturma veya silme yetkisini açar/kapatır. |
Özellikler
API Developer Portal tarafında kullanılacak olan özellikler, bu ekran üzerinden yönetilir.
Özellikler Ayarları
| Alan | Açıklama |
|---|---|
| Nasıl kullanılır menüsünü aktifleştir (Activate the How to use menu) | Features sekmesi → Enable How It Works. Nasıl kullanılır menüsü kullanıcılara görünür. Portal’da kullanıcılara rehberlik edecek bir sayfa göstermek veya gizlemek amacı ile kullanılır. Aktif olması durumunda Menüde “How It Works” / “Nasıl Çalışır” linki görünür, Portal Appearance’ta tanımlanan How It Works HTML içeriği gösterilir, kullanıcılar bu sayfaya erişebilir. |
| Test araçları menüsünü aktifleştir (Activate the Test Tools menu) | Features sekmesi → Enable Test Tools. Test araçları menüsünü kullanıcılara görünür. Kullanıcıların API’leri portal üzerinden test etmelerini sağlamak, Swagger UI benzeri test arayüzü sunmak amacı ile kullanılır. Aktif olması durumunda API dokümantasyonunda “Try It” butonu görünür, kullanıcılar portal üzerinden API çağrısı yapabilir, Request/Response preview aktif olur. |
| Jira ile API Portal Entegrasyonunu tanımlama (Define Your API Portal Integration with Jira) | Features sekmesi → Enable Jira Integration. Jira Entegrasyonu menüsü görünür. Portal üzerinden Jira ticket’ları oluşturma özelliği sağlamak, Destek sürecini otomatikleştirmek amacı ile kullanılır. Aktif olması durumunda Kullanıcılar portal’dan Jira ticket açabilir, “Report Issue” veya “Request Feature” butonları görünür, Jira entegrasyonu çalışır. |
| MCP (Model Context Protocol) Özelliğini Etkinleştir | Features sekmesi → Enable MCP. AI asistanları ve araçlar sistemin bağlam verilerine ulaşabilir ve onları kullanabilir. Aktif olamsı durumunda MCP özellikleri kullanılabilir. |
| Hesapların Analytcis bilgilerini görüntülemesine izin ver (Allow accounts to view their Analytics information) | Features sekmesi → Enable Analytics. Hesaplar kendi analitik bilgilerini görüntüler. Kullanıcılara API kullanım istatistiklerini göstermek, Dashboard’ları aktif etmek amacı ile kullanılır. Aktif olması durumunda Analytics dashboard kullanıcılara görünür, API call istatistikleri gösterilir, Grafikler ve raporlar aktif durumunda olur. |
| API Performans Metriklerinizi Tanımlayın (Define your API Performance Metrics) | Features sekmesi → Performance Metrics. Bu bölümde, aşağıdaki alanlara ait yapılandırmalar yapılır; İyi Performans İçin Maksimum Kabul Edilebilir Değer (Max Acceptable Value For Good Performance): Bir isteğin beklenen zamanda yanıtlanma süresinin, normal olduğunu gösteren maksimum değer girilir. Kötü Performans için Minimum Kabul Edilebilir Değer (Min Acceptable Value For Bad Performance): Bir isteğin beklenen zamanda yanıtlanma süresinin, anormal olduğunu gösteren minimum değer girilir. |
Yasal
API Developer Portal tarafında kullanılacak olan yasal ayarlar, bu ekran üzerinden yönetilir.
Yasal Ayarlar
| Alan | Açıklama |
|---|---|
| Yasal Dosya (Define your API Portal Legal Agreement) | API Portalını kullanırken geçerli olan kullanım koşulları, gizlilik politikası ve yasal yükümlülüklerin belirtildiği bir belgedir. 1. PDF dosyanızı hazırlayın (Terms of Service, Privacy Policy, vb.) 2. “Upload PDF” butonuna tıklayın 3. Dosyayı seçin ve yükleyin 4. Yüklenen dosya görünecek ve “Open” ile önizleyebilirsiniz |
Portal İçerik Yönetimi
API Portal Ayarları sayfasında, portalın içerik sayfalarını yönetebilirsiniz. Bu bölümde ana sayfa, footer, “Nasıl Çalışır” sayfası, bekleyen sayfa ve navigasyon menüsü ayarlarını yapabilirsiniz.
Portal İçerik Sayfaları Yönetimi
Portal Sayfalarına Genel Bakış
Her portal oluşturulduğunda, sistem otomatik olarak bir dizi varsayılan (default) sayfa oluşturur. Bu sayfalar portalın temel işlevselliğini sağlar ve kullanıcılar tarafından görüntülenebilir. Varsayılan Portal Sayfaları:| Sayfa Tipi | Açıklama | Erişim Durumu | Varsayılan İçerik |
|---|---|---|---|
| Portal Home (Ana Sayfa) | Kullanıcıların portala ilk girdiğinde gördükleri ana sayfa | Public (Herkese açık) | Varsayılan karşılama mesajı ve portal tanıtımı |
| Footer (Alt Bilgi) | Portalın en alt kısmında görünen footer alanı | Public (Tüm sayfalarda görünür) | Varsayılan footer içeriği (boş veya minimal) |
| How It Works (Nasıl Çalışır) | Portal kullanım rehberi sayfası | Public (Özellik aktifse) | Varsayılan kullanım rehberi içeriği |
| Pending Page (Bekleyen Sayfa) | Hesap onayı bekleyen kullanıcılar için sayfa | Private (Sadece bekleme durumundaki kullanıcılar) | Varsayılan bekleme mesajı |
| Login Page (Giriş Sayfası) | Kullanıcı giriş sayfası | Public (Giriş yapmamış kullanıcılar) | Sistem tarafından otomatik oluşturulur |
| Register Page (Kayıt Sayfası) | Kullanıcı kayıt sayfası | Public (Kayıt izni varsa) | Sistem tarafından otomatik oluşturulur |
| API Catalog (API Kataloğu) | Yayınlanmış API’lerin listelendiği sayfa | Public (Giriş yapmış kullanıcılar) | Sistem tarafından otomatik oluşturulur |
| My Apps (Uygulamalarım) | Kullanıcının uygulamalarını yönettiği sayfa | Private (Sadece giriş yapmış kullanıcılar) | Sistem tarafından otomatik oluşturulur |
Sayfa Erişim Durumları
Portal sayfaları, erişim durumlarına göre kategorize edilir:Public (Herkese Açık) Sayfalar
Public (Herkese Açık) Sayfalar
Public sayfalar, giriş yapmamış kullanıcılar dahil herkes tarafından görüntülenebilir:
- Portal Home: Ana sayfa herkese açıktır
- Footer: Tüm sayfalarda görünür
- How It Works: Özellik aktifse herkese açıktır
- Login Page: Giriş sayfası herkese açıktır
- Register Page: Kayıt izni varsa herkese açıktır
- API Catalog: Yayınlanmış API’ler herkese görünür (detaylar için giriş gerekebilir)
Public sayfalar, portalın tanıtımı ve kullanıcı kazanımı için kritik öneme sahiptir.
Private (Özel) Sayfalar
Private (Özel) Sayfalar
Private sayfalar, sadece giriş yapmış ve yetkili kullanıcılar tarafından görüntülenebilir:
- My Apps: Sadece giriş yapmış kullanıcılar kendi uygulamalarını görebilir
- Analytics: Sadece giriş yapmış kullanıcılar kendi istatistiklerini görebilir
- API Details: Bazı API detayları sadece abone olan kullanıcılara açıktır
- Pending Page: Sadece bekleme durumundaki kullanıcılar görür
Conditional (Koşullu) Sayfalar
Conditional (Koşullu) Sayfalar
Conditional sayfalar, belirli koşullara göre görünür veya gizlenir:
- How It Works: Portal Ayarları → Özellikler’de “How It Works” aktifse görünür
- Test Tools: Portal Ayarları → Özellikler’de “Test Tools” aktifse görünür
- Analytics: Portal Ayarları → Özellikler’de “Analytics” aktifse ve kullanıcı giriş yapmışsa görünür
- Jira Integration: Portal Ayarları → Özellikler’de “Jira Integration” aktifse görünür
Conditional sayfalar, portal yöneticisi tarafından özellik ayarlarından kontrol edilir.
Portal Sayfalarının Çalışma Mantığı
1. Sayfa Oluşturma ve Yönetimi: Her portal için sayfalar iki şekilde oluşturulur:- Sistem Tarafından Otomatik Oluşturulan Sayfalar
- Yönetici Tarafından Yönetilen Sayfalar
Otomatik Oluşturulan Sayfalar:
- Portal oluşturulduğunda sistem tarafından otomatik oluşturulur
- İçerikleri varsayılan değerlerle gelir
- İçerikler düzenlenebilir
- Login Page (Giriş Sayfası)
- Register Page (Kayıt Sayfası)
- API Catalog (API Kataloğu)
- My Apps (Uygulamalarım)
Bu sayfalar portalın temel işlevselliğini sağlar ve sistem tarafından yönetilir.
| Yönetim Yöntemi | Açıklama | Kullanılan Sayfalar |
|---|---|---|
| HTML Editörü | HTML kodları ile içerik oluşturma | Portal Home, Footer, How It Works, Pending Page |
| Sistem Yönetimi | Sistem tarafından otomatik oluşturulan içerik | Login, Register, API Catalog, My Apps |
| Dinamik İçerik | API’lerden ve veritabanından gelen içerik | API Catalog, My Apps, Analytics |
- Varsayılan Dil: Portal Ayarları → Genel Ayarlar’dan belirlenir (sistemde tanımlı tüm dillerden seçilebilir)
- Dil Seçenekleri: Sistemde tanımlı tüm dillerden istediğiniz kadarını aktif edebilirsiniz (Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, İtalyanca, vb.)
- İçerik Yönetimi: Her dil için ayrı içerik hazırlanabilir
- Otomatik Yönlendirme: Sistem kullanıcının dil tercihine göre uygun içeriği gösterir
Çoklu dil özelliği aktif olduğunda, Portal Home, Footer, How It Works ve Pending Page için etkinleştirilen her dilde ayrı içerik hazırlanabilir. Sistem sadece Türkçe ve İngilizce ile sınırlı değildir; sistemde tanımlı tüm dilleri destekler.
- Portal Ayarları: Özellik ayarlarından sayfalar aktif/pasif yapılabilir
- Kullanıcı Durumu: Giriş yapmış/yapmamış kullanıcı durumuna göre
- Kullanıcı Rolleri: Kullanıcı rolüne göre (Admin, Developer, Guest)
- API Abonelik Durumu: Bazı sayfalar sadece abone olan kullanıcılara açıktır
Sayfa Yönetimi İşlemleri
Portal sayfalarını yönetmek için aşağıdaki işlemleri yapabilirsiniz:İçerik Düzenleme
Portal Home, Footer, How It Works ve Pending Page içeriklerini HTML editörü ile düzenleyin
Çoklu Dil Yönetimi
Her sayfa için etkinleştirilen tüm dillerde içerik hazırlayın (Türkçe, İngilizce, Almanca, Fransızca, vb.)
Önizleme
Değişiklikleri kaydetmeden önce önizleyin
Görünürlük Kontrolü
Sayfaların görünürlüğünü özellik ayarlarından kontrol edin
Portal Ana Sayfa (Portal Home)
Portal ana sayfası, kullanıcıların portala ilk girdiğinde gördükleri sayfadır. Bu sayfada portalın tanıtım metinleri, yönlendirici açıklamalar, bağlantılar veya görsel içerikler yer alır. Portal Ana Sayfası Özellikleri:| Özellik | Açıklama |
|---|---|
| Erişim Durumu | Public (Herkese açık) - Giriş yapmamış kullanıcılar dahil herkes erişebilir |
| Varsayılan İçerik | Portal oluşturulduğunda varsayılan karşılama mesajı ve portal tanıtımı ile gelir |
| İçerik Formatı | HTML formatında içerik eklenebilir (başlıklar, paragraflar, listeler, bağlantılar, görseller) |
| Çoklu Dil | Etkinleştirilen tüm dillerde içerik hazırlanabilir (Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, vb.) |
| Önizleme | Değişiklikler kaydetmeden önce önizlenebilir |
| URL | Portal ana URL’si (örn: https://portal.company.com/) |
Portal Ana Sayfa Ayarları
- Karşılama Başlığı: “Welcome to [Portal Name]”
- Kısa Açıklama: Portal hakkında genel bilgi
- Aksiyon Kartları:
- “How It Works?” - Nasıl çalışır sayfasına yönlendirme
- “Discover Our APIs” - API kataloğuna yönlendirme
- “Register” - Kayıt sayfasına yönlendirme
- “Contact Us” - İletişim sayfasına yönlendirme
Varsayılan içerik, portal yöneticisi tarafından tamamen özelleştirilebilir. HTML editörü ile istediğiniz içeriği ekleyebilirsiniz.
1
Portal Ana Sayfa Sekmesine Git
- API Portal Ayarları sayfasında “Portal Home” veya “Ana Sayfa” sekmesine tıklayın
- Ana sayfa içerik düzenleme ekranı açılır
2
İçerik Düzenleme
Sol tarafta HTML editörü bulunur. Bu editörde:
- HTML kodları yazabilirsiniz
- Markdown formatı kullanabilirsiniz
- Başlıklar, paragraflar, listeler, bağlantılar ekleyebilirsiniz
- Görseller ve tablolar ekleyebilirsiniz
HTML editörü zengin metin düzenleme özellikleri sunar. Kod görünümü ve görsel görünüm arasında geçiş yapabilirsiniz.
3
Çoklu Dil Desteği
Portal ayarlarında çoklu dil aktifse, etkinleştirilen her dil için ayrı sekme görürsünüz:
- Portal Home (TR): Türkçe içerik alanı
- Portal Home (EN): İngilizce içerik alanı
- Portal Home (DE): Almanca içerik alanı (eğer aktifse)
- Portal Home (FR): Fransızca içerik alanı (eğer aktifse)
- Ve diğer etkinleştirilen diller…
4
Önizleme
Sağ tarafta “Preview (Önizleme)” bölümü bulunur:
- Yazdığınız HTML içeriğinin portalda nasıl görüneceğini anlık olarak görebilirsiniz
- Değişiklikler yaparken önizleme otomatik güncellenir
- Mobil ve masaüstü görünümünü kontrol edebilirsiniz
5
İçeriği Kaydetme
- İçeriği hazırladıktan sonra sayfanın üst kısmındaki “Save” butonuna tıklayın
- Değişiklikler kaydedilir ve portal ana sayfasına anında yansır
- Portal kullanıcıları sayfayı yenilediğinde yeni içeriği görür
- Portal karşılama mesajı ve başlığı
- Portal hakkında kısa açıklama
- “How It Works?”, “Discover Our APIs”, “Register”, “Contact Us” gibi aksiyon kartları
- Öne çıkan API’ler veya özellikler
- Kurumsal bilgiler ve bağlantılar
- Görseller, banner’lar veya video içerikleri
- İstatistikler veya başarı hikayeleri
-
Giriş Yapmamış Kullanıcılar:
- Ana sayfayı görüntüleyebilir
- Portal hakkında bilgi alabilir
- “Register” butonuna tıklayarak kayıt olabilir
- “Discover Our APIs” ile API kataloğunu görebilir (sadece yayınlanmış API’ler)
-
Giriş Yapmış Kullanıcılar:
- Ana sayfayı görüntüleyebilir
- “My Apps” menüsüne erişebilir
- API’lere abone olabilir
- Analytics sayfasına erişebilir (özellik aktifse)
-
Yöneticiler:
- Ana sayfayı görüntüleyebilir
- Tüm özelliklere erişebilir
- Portal yönetim işlemlerini yapabilir
Ana sayfa içeriği HTML formatında olduğu için, CSS stilleri ve JavaScript kodları da kullanabilirsiniz. Ancak karmaşık script’ler portal performansını etkileyebilir. Güvenlik açısından sadece güvendiğiniz script’leri kullanın.
Footer (Alt Bilgi)
Footer, portalın en alt kısmında görüntülenen içerik alanıdır. Genellikle iletişim bilgileri, yasal metinler, telif hakkı ifadeleri veya kurumsal bağlantılar burada yer alır. Footer Özellikleri:| Özellik | Açıklama |
|---|---|
| Erişim Durumu | Public (Herkese açık) - Tüm sayfalarda görünür |
| Varsayılan İçerik | Portal oluşturulduğunda varsayılan footer içeriği ile gelir (genellikle boş veya minimal) |
| Görünürlük | Tüm portal sayfalarının altında görünür (Home, APIs, How It Works, vb.) |
| İçerik Formatı | HTML formatında içerik eklenebilir (tablolar, listeler, bağlantılar, görseller) |
| Çoklu Dil | Etkinleştirilen tüm dillerde içerik hazırlanabilir (Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, vb.) |
| Script Desteği | JavaScript kodları çalıştırılabilir (ör: canlı chat widget’ları) |
- Ana sayfa (Home)
- API kataloğu (API Catalog)
- API detay sayfaları
- How It Works sayfası
- Login ve Register sayfaları
- Kullanıcı paneli sayfaları (My Apps, Analytics)
Footer içeriği, portalın tüm sayfalarında tutarlı bir şekilde görüntülenir. Bu sayede kullanıcılar her sayfada iletişim bilgilerine ve yasal bağlantılara erişebilir.
1
Footer Sekmesine Git
- API Portal Ayarları sayfasında “Footer” veya “Alt Bilgi” sekmesine tıklayın
- Footer içerik düzenleme ekranı açılır
2
Footer İçeriğini Düzenleme
Sol taraftaki HTML editöründe footer içeriğini hazırlayın:
- İletişim bilgileri (adres, telefon, e-posta)
- Sosyal medya bağlantıları ve ikonları
- Yasal metinler (Kullanım Koşulları, Gizlilik Politikası)
- Telif hakkı (Copyright) bilgisi
- Kurumsal bağlantılar ve linkler
- Logo veya görseller
Footer içeriği HTML formatında olduğu için, tablolar, listeler ve bağlantılar ekleyebilirsiniz.
3
Çoklu Dil Desteği
Çoklu dil aktifse:
- Footer (EN): İngilizce footer içeriği
- Footer (TR): Türkçe footer içeriği
4
Önizleme ve Kaydetme
- Sağ tarafta footer’ın portalda nasıl görüneceğini önizleyebilirsiniz
- Değişiklikleri yaptıktan sonra “Save” butonuna tıklayın
- Footer içeriği portalın alt kısmına anında yansır
- Şirket adı ve logosu
- İletişim bilgileri (adres, telefon, e-posta)
- Sosyal medya ikonları (LinkedIn, Twitter, GitHub vb.)
- Hızlı bağlantılar (Hakkımızda, Destek, Dokümantasyon)
- Yasal bağlantılar (Kullanım Koşulları, Gizlilik Politikası)
- Telif hakkı bilgisi (© 2024 Şirket Adı)
How It Works (Nasıl Çalışır)
“How It Works” sayfası, portal kullanıcılarına sistemin genel işleyişini, API erişim sürecini veya kayıt/adım adım kullanım rehberini anlatan bilgilendirici sayfadır. How It Works Özellikleri:| Özellik | Açıklama |
|---|---|
| Erişim Durumu | Public (Herkese açık) - Özellik aktifse herkes erişebilir |
| Varsayılan İçerik | Portal oluşturulduğunda varsayılan kullanım rehberi içeriği ile gelir |
| Görünürlük Kontrolü | Portal Ayarları → Özellikler’de “How It Works” aktifse görünür |
| Menü Konumu | Portal üst menüsünde “How It Works?” veya “Nasıl Çalışır?” linki olarak görünür |
| İçerik Formatı | HTML formatında içerik eklenebilir (adım adım rehber, ikonlar, listeler) |
| Çoklu Dil | Etkinleştirilen tüm dillerde içerik hazırlanabilir (Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, vb.) |
| URL | Portal URL’si + /how-it-works (örn: https://portal.company.com/how-it-works) |
- Başlık: “How It Works” veya “Nasıl Çalışır”
- Genel Açıklama: Portal kullanımı hakkında genel bilgi
- Adım Adım Rehber: Temel kullanım adımları
- API Erişim Süreci: API’lere nasıl erişileceği
- Kayıt Süreci: Portal’a nasıl kayıt olunacağı
How It Works sayfası, portal yöneticisi tarafından tamamen özelleştirilebilir. İçeriğe adım adım rehber, görseller, ikonlar ve örnekler eklenebilir.
-
Özellik Aktifse:
- Portal Ayarları → Özellikler → “How It Works” aktifse
- Portal üst menüsünde “How It Works?” linki görünür
- Herkes (giriş yapmış/yapmamış) sayfaya erişebilir
-
Özellik Pasifse:
- Portal üst menüsünde link görünmez
- Sayfa içeriği hazırlanmış olsa bile kullanıcılar erişemez
- Direkt URL ile erişim mümkün olmayabilir
1
How It Works Sekmesine Git
- API Portal Ayarları sayfasında “How It Works” veya “Nasıl Çalışır” sekmesine tıklayın
- How It Works içerik düzenleme ekranı açılır
2
İçerik Hazırlama
Sol taraftaki HTML editöründe içeriği hazırlayın:
- Adım adım kullanım rehberi
- API erişim süreci açıklaması
- Kayıt ve hesap oluşturma adımları
- API kullanım örnekleri
- Sık sorulan sorular
- İkonlar, numaralı listeler ve görseller
How It Works sayfası, kullanıcı deneyimini artırmak ve portalın kullanımını açıklamak için hazırlanır.
3
Çoklu Dil Desteği
Çoklu dil aktifse:
- How It Works (EN): İngilizce içerik
- How It Works (TR): Türkçe içerik
4
Portal Menüsünde Görünüm
- How It Works sayfası, portal üst menüsünde “How It Works?” veya “Nasıl Çalışır?” linki olarak görünür
- Bu linke tıklandığında hazırladığınız içerik gösterilir
- Menüde görünmesi için Portal Ayarları → Özellikler bölümünde “How It Works” özelliğinin aktif olması gerekir
5
Kaydetme
- İçeriği hazırladıktan sonra “Save” butonuna tıklayın
- Değişiklikler kaydedilir ve portal menüsünden erişilebilir hale gelir
- Portal’a kayıt olma adımları
- API’leri keşfetme ve inceleme süreci
- Uygulama kaydı ve API abonelik süreci
- API key’leri alma ve kullanma
- API çağrısı yapma adımları
- Sorun giderme ve destek bilgileri
Pending Page (Bekleyen Sayfa)
Pending Page, kullanıcıların hesap onayı beklerken veya belirli bir işlem tamamlanana kadar görüntüledikleri bekleme sayfasıdır. Bu sayfa, kullanıcılara durumları hakkında bilgi verir ve ne yapmaları gerektiğini açıklar. Pending Page Özellikleri:| Özellik | Açıklama |
|---|---|
| Erişim Durumu | Private (Özel) - Sadece bekleme durumundaki kullanıcılar görür |
| Varsayılan İçerik | Portal oluşturulduğunda varsayılan bekleme mesajı ile gelir |
| Görünürlük | Sadece belirli durumlardaki kullanıcılar için otomatik gösterilir |
| İçerik Formatı | HTML formatında içerik eklenebilir (mesajlar, talimatlar, görseller) |
| Çoklu Dil | Etkinleştirilen tüm dillerde içerik hazırlanabilir (Türkçe, İngilizce, Almanca, Fransızca, İspanyolca, vb.) |
| Otomatik Yönlendirme | Sistem kullanıcı durumuna göre otomatik olarak bu sayfaya yönlendirir |
- Başlık: “Your Account is Pending Approval” veya “Hesabınız Onay Bekliyor”
- Açıklama: Hesap onay süreci hakkında bilgi
- Bekleme Mesajı: “Your account is being reviewed. You will be notified once it’s approved.”
- İletişim Bilgisi: Destek ekibi ile iletişime geçme talimatları
Pending Page içeriği, kullanıcıların durumlarını anlamalarına ve ne yapmaları gerektiğini bilmelerine yardımcı olmalıdır. Güven verici ve bilgilendirici bir ton kullanılmalıdır.
Hesap Onayı Bekleme
Hesap Onayı Bekleme
Senaryo: Kullanıcı kayıt oldu ve e-posta onayladı, ancak hesap henüz yönetici tarafından onaylanmadı.Koşullar:
- Portal Ayarları → Güvenlik → “Auto Approve Account” = PASIF
- Kullanıcı e-posta adresini onaylamış
- Yönetici henüz hesabı onaylamamış
- Kullanıcı giriş yapmaya çalıştığında Pending Page görüntülenir
- “Your account is pending approval” mesajı gösterilir
- Kullanıcı portal içeriğine erişemez
API Abonelik Onayı Bekleme
API Abonelik Onayı Bekleme
Senaryo: Kullanıcı bir API’ye abone oldu, ancak abonelik henüz onaylanmadı.Koşullar:
- Portal Ayarları → Güvenlik → “Auto Approve API Subscribe” = PASIF
- Kullanıcı API’ye abone olmuş
- Yönetici henüz aboneliği onaylamamış
- Kullanıcı API detay sayfasına gittiğinde Pending Page görüntülenebilir
- “Your subscription is pending approval” mesajı gösterilir
- API’yi kullanamaz
Hesap Askıya Alınma
Hesap Askıya Alınma
Senaryo: Kullanıcı hesabı geçici olarak askıya alındı.Koşullar:
- Yönetici kullanıcı hesabını askıya almış
- Hesap tamamen silinmemiş, sadece geçici olarak devre dışı
- Kullanıcı giriş yapmaya çalıştığında Pending Page görüntülenir
- “Your account is temporarily suspended” mesajı gösterilir
- İletişim bilgileri verilir
1
Pending Page Sekmesine Git
- API Portal Ayarları sayfasında “Pending Page” veya “Bekleyen Sayfa” sekmesine tıklayın
- Pending Page içerik düzenleme ekranı açılır
2
Bekleme Sayfası İçeriğini Hazırlama
Sol taraftaki HTML editöründe içeriği hazırlayın:
- Kullanıcıya durum hakkında bilgi veren mesaj
- Ne yapması gerektiğini açıklayan talimatlar
- Bekleme süresi hakkında bilgi
- İletişim bilgileri (sorular için)
- Görsel öğeler (ikonlar, animasyonlar)
Pending Page, kullanıcıların hesap onayı beklerken veya manuel onay sürecinde görüntülediği sayfadır.
3
Çoklu Dil Desteği
Çoklu dil aktifse:
- Pending Page (EN): İngilizce içerik
- Pending Page (TR): Türkçe içerik
4
Ne Zaman Görüntülenir
Pending Page aşağıdaki durumlarda görüntülenir:
- Kullanıcı kayıt oldu ve e-posta onayladı, ancak hesap henüz onaylanmadı (Auto Approve Account = PASIF)
- Kullanıcı API’ye abone oldu, ancak abonelik henüz onaylanmadı (Auto Approve API Subscribe = PASIF)
- Kullanıcı hesabı askıya alındı veya geçici olarak devre dışı bırakıldı
5
Kaydetme
- İçeriği hazırladıktan sonra “Save” butonuna tıklayın
- Değişiklikler kaydedilir ve bekleme durumundaki kullanıcılar bu sayfayı görür
- “Hesabınız onay bekliyor” mesajı
- Onay süreci hakkında bilgi
- Bekleme süresi tahmini
- İletişim bilgileri (sorular için destek ekibi)
- Durum kontrolü için talimatlar
- Güven verici mesajlar
Navigation Menu (Navigasyon Menüsü)
Navigation Menu, portalın üst kısmında görünen menü yapısını yönetmenizi sağlar. Bu menüde hangi sayfaların görüneceğini, sıralamasını ve görünürlüğünü kontrol edebilirsiniz. Navigation Menu Özellikleri:| Özellik | Açıklama |
|---|---|
| Konum | Portalın üst kısmında, logo ve kullanıcı menüsü arasında |
| Varsayılan Menü Öğeleri | Portal oluşturulduğunda varsayılan menü öğeleri ile gelir |
| Dinamik Menü | Menü öğeleri kullanıcı durumuna göre görünür/gizlenir |
| Özelleştirilebilir | Menü öğeleri eklenebilir, düzenlenebilir, silinebilir ve sıralanabilir |
| Çoklu Dil | Menü etiketleri çoklu dilde görüntülenebilir |
| Koşullu Görünürlük | Menü öğeleri kullanıcı rolüne veya durumuna göre gösterilir |
| Menü Öğesi | Açıklama | Görünürlük | URL |
|---|---|---|---|
| Home | Ana sayfa linki | Herkese açık | / |
| APIs | API kataloğu sayfası | Herkese açık | /api-products |
| How It Works | Nasıl çalışır sayfası | Özellik aktifse | /how-it-works |
| Test Tools | Test araçları sayfası | Özellik aktifse ve giriş yapmış | /tools |
| My Apps | Kullanıcının uygulamaları | Sadece giriş yapmış | /my-apps |
| Analytics | Analytics sayfası | Özellik aktifse ve giriş yapmış | /analytics |
Varsayılan menü öğeleri sistem tarafından otomatik oluşturulur ve silinemez. Ancak görünürlükleri ve sıralamaları değiştirilebilir.
- Her Zaman Görünür
- Özellik Aktifse Görünür
- Giriş Yapmış Kullanıcılar İçin
Sistem Menü Öğeleri:
- Home: Her zaman görünür (silinemez)
- APIs: Her zaman görünür (silinemez)
Navigasyon Menüsü Yönetimi
1
Navigation Menu Sekmesine Git
- API Portal Ayarları sayfasında “Navigation Menu” veya “Navigasyon Menüsü” sekmesine tıklayın
- Navigasyon menü yönetim ekranı açılır
2
Menü Öğelerini Yönetme
Navigasyon menüsünde aşağıdaki işlemleri yapabilirsiniz:Menü Öğeleri:
- Home: Ana sayfa linki
- APIs: API kataloğu sayfası
- How It Works: Nasıl Çalışır sayfası (özellik aktifse görünür)
- Test Tools: Test araçları sayfası (özellik aktifse görünür)
- My Apps: Kullanıcının uygulamaları sayfası (giriş yapmış kullanıcılar için)
- Analytics: Analytics sayfası (özellik aktifse ve kullanıcı giriş yapmışsa)
- Görünürlük: Menü öğesinin görünür olup olmayacağını belirleyin
- Sıralama: Menü öğelerinin sırasını değiştirin (sürükle-bırak veya sıra numarası)
- Etiket: Menü öğesinin görünen adını değiştirin
- Bağlantı: Menü öğesinin yönlendireceği sayfayı belirleyin
3
Menü Öğesi Ekleme
Yeni bir menü öğesi eklemek için:
- ”+ Add Menu Item” veya ”+ Menü Öğesi Ekle” butonuna tıklayın
- Menü öğesi formu açılır
- Etiket: Menüde görünecek adı girin
- Bağlantı: Yönlendirilecek URL’i girin (iç veya dış bağlantı)
- Sıra: Menüdeki konumunu belirleyin
- Görünürlük: Hangi kullanıcılar için görünür olacağını seçin (Tümü, Sadece Giriş Yapmış, Sadece Misafir)
- “Save” butonuna tıklayın
4
Menü Öğesi Düzenleme
Mevcut bir menü öğesini düzenlemek için:
- Menü öğesinin yanındaki “Edit” veya düzenleme ikonuna tıklayın
- Menü öğesi formu açılır
- Değişiklikleri yapın
- “Save” butonuna tıklayın
5
Menü Öğesi Silme
Bir menü öğesini silmek için:
- Menü öğesinin yanındaki “Delete” veya silme ikonuna tıklayın
- Onay dialogunda “Yes” deyin
- Menü öğesi menüden kaldırılır
6
Menü Sıralamasını Değiştirme
Menü öğelerinin sırasını değiştirmek için:
- Menü öğesini sürükleyip istediğiniz konuma bırakın (drag & drop)
- Veya sıra numarası alanından sırayı değiştirin
- Değişiklikler anında önizlenir
7
Kaydetme
- Tüm değişiklikleri yaptıktan sonra sayfanın üst kısmındaki “Save” butonuna tıklayın
- Menü yapısı kaydedilir ve portal üst menüsünde anında görünür
| Özellik | Açıklama |
|---|---|
| Dinamik Menü | Menü öğeleri kullanıcı durumuna göre görünür/gizlenir |
| Çoklu Dil Desteği | Menü etiketleri çoklu dilde görüntülenebilir |
| Koşullu Görünürlük | Menü öğeleri kullanıcı rolüne veya durumuna göre gösterilir |
| Özel Bağlantılar | İç sayfalara veya dış web sitelerine bağlantı eklenebilir |
| Sıralama | Menü öğelerinin sırası özelleştirilebilir |
Navigasyon menüsü, portalın kullanıcı deneyimini doğrudan etkiler. Menü yapısını kullanıcıların ihtiyaçlarına göre düzenleyerek daha iyi bir deneyim sunabilirsiniz.
Portal İçerik Yönetimi Özeti
Portal Sayfalarının Yönetim Mantığı: Portal içerik yönetimi, aşağıdaki prensiplere göre çalışır: 1. Varsayılan Sayfalar:- Her portal oluşturulduğunda sistem tarafından otomatik oluşturulur
- Varsayılan içeriklerle gelir
- İçerikleri özelleştirilebilir
- Portal Ayarları → Portal İçerik Yönetimi bölümünden yönetilir
- HTML formatında içerik eklenebilir
- Çoklu dil desteği vardır
- Önizleme özelliği bulunur
- Public Sayfalar: Herkese açık (giriş yapmamış kullanıcılar dahil)
- Private Sayfalar: Sadece giriş yapmış kullanıcılar
- Conditional Sayfalar: Özellik ayarlarına göre görünür/gizlenir
- Portal Ayarları → Genel Ayarlar’da çoklu dil aktifse
- Her sayfa için Türkçe ve İngilizce içerik hazırlanabilir
- Sistem kullanıcının dil tercihine göre uygun içeriği gösterir
- İçerik değişiklikleri anında portala yansır
- Sayfa yenileme (refresh) yeterlidir
- Tarayıcı cache’i temizlenmesi gerekebilir
| Sayfa | Varsayılan İçerik | Erişim | Özelleştirilebilir | Çoklu Dil | Önizleme |
|---|---|---|---|---|---|
| Portal Home | Var | Public | Evet | Evet | Evet |
| Footer | Minimal | Public | Evet | Evet | Evet |
| How It Works | Var | Public (özellik aktifse) | Evet | Evet | Evet |
| Pending Page | Var | Private (bekleme durumundaki) | Evet | Evet | Evet |
| Login Page | Sistem | Public | Hayır | Evet | Hayır |
| Register Page | Sistem | Public (izin varsa) | Hayır | Evet | Hayır |
| API Catalog | Sistem | Public | Hayır | Evet | Hayır |
| My Apps | Sistem | Private | Hayır | Evet | Hayır |
SEO
API Developer Portal tarafında kullanılacak olan SEO ayarları, bu ekran üzerinden yönetilir.
SEO Ayarları
| Alan | Açıklama |
|---|---|
| SEO robots.txt | Arama motoru botlarına sitenizde hangi sayfaları tarayıp indeksleyebileceklerini veya hangi sayfalara erişemeyeceklerini söyleyen bir metin dosyasıdır. Bu sayede site sahipleri, arama motorlarının sitelerini daha verimli ve kontrollü bir şekilde taramasını sağlar. |
Danger Zone (Tehlikeli Bölge)
Danger Zone, portal için kritik ve geri alınamaz işlemlerin yapıldığı bölümdür. Bu bölümde portal silme gibi kalıcı işlemler yer alır.
Danger Zone - Kritik İşlemler
Portal Silme
Portal silme işlemi, portalı ve tüm verilerini kalıcı olarak siler. Bu işlem geri alınamaz.1
Danger Zone Sekmesine Git
- API Portal Ayarları sayfasında “Danger Zone” veya “Tehlikeli Bölge” sekmesine tıklayın
- Kritik işlemler listelenir
2
Portal Silme Butonuna Tıklama
- “Delete Portal” veya “Portali Sil” butonuna tıklayın
- Onay dialogu açılır
3
Portal Adını Onaylama
- Onay dialogunda portal adını tam olarak yazmanız istenir
- Portal adını doğru girdiğinizden emin olun
- Bu adım yanlışlıkla silmeyi önlemek içindir
4
Silme İşlemini Onaylama
- Portal adını doğru girdikten sonra “Yes, Delete” veya “Evet, Sil” butonuna tıklayın
- Portal kalıcı olarak silinir
- Tüm veriler (kullanıcılar, API’ler, içerikler, istatistikler) silinir
| Veri Tipi | Durum |
|---|---|
| Portal Konfigürasyonu | Kalıcı olarak silinir |
| Kullanıcı Hesapları | Tüm kullanıcı hesapları silinir |
| API Ürünleri | Tüm API ürünleri silinir |
| Uygulama Kayıtları | Tüm uygulama kayıtları silinir |
| API Anahtarları | Tüm API anahtarları silinir |
| İçerikler | Tüm içerik sayfaları silinir |
| İstatistikler | Tüm analytics verileri silinir |
| Dosyalar | Tüm yüklenmiş dosyalar silinir |