Sıklıkla Sorulan Sorular

API Developer Portal kullanıcılarının sıkça yönelttiği soruların ve yanıtlarının yönetilmesini sağlar. Yönetici kullanıcılar, hem İngilizce hem Türkçe dillerinde soru-cevap içerikleri tanımlayarak portalın kullanıcı deneyimini zenginleştirir. Bu sayede, API tüketicileri portal üzerinden sıkça merak edilen bilgilere hızlıca erişebilir.

Sık Sorulan Sorular listesi, kullanıcıların API Portal’ı, API kullanım yöntemlerini veya genel kavramları daha iyi anlamalarına yardımcı olacak biçimde yapılandırılır.

İçindekiler

Sık Sorulan Soruların Kullanımı

Tanımlanan sorular, API Developer Portal üzerinde “Frequently Asked Questions” sayfasında görüntülenir.
Kullanıcılar bu alanda sık sorulan soruları kategoriye göre filtreleyebilir, detaylı yanıtları inceleyebilir.

Bu yapı sayesinde:

API tüketicileri sık karşılaşılan konularda hızlı çözüm bulur,
Destek yükü azalır,
Portalın kullanım kolaylığı ve rehberlik gücü artar.

Sık Sorulan Sorular liste ekran detaylarını içeren görsele aşağıda yer verilmiştir:

Alan	Açıklama
Soru (Question)	İngilizce olarak sık sorulan sorunun metnidir. API Portal’da kullanıcı dil tercihi İngilizce olduğunda bu alan görüntülenir.
Cevap (Answer)	Soruya ait yanıt metnidir. Açıklayıcı ve bilgilendirici olmalıdır.
Categori (Category)	Soru hangi konuya ait ise burada kategori seçilir.
Soru(TR) (Question(TR))	Çoklu dil desteği aktif olduğunda görüntülenir. Sorunun türkçe versiyonu bu alana girilir.
Cevap(TR) (Answer(TR))	Çoklu dil desteği aktif olduğunda görüntülenir. Sorunun türkçe yanıtı bu alana girilir.
Categori(TR) (Category(TR))	Türkçe kategori adıdır. Portal türkçe dilinde görüntülendiğinde bu değer gösterilir.

Portal ayarlarında hem Türkçe Dil Seçeneği hem de İngilizce 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, form alanları hem İngilizce hem Türkçe olarak görüntülenir, her dil içinde ayrı veri girişi yapılabilir.

Yeni Soru Oluşturma

Yeni bir sık sorulan soru oluşturmak için ekranın sağ üst kısmındaki Create (+) butonuna tıklanır. Açılan pencerede (modal) aşağıdaki alanlar doldurularak kayıt işlemi tamamlanır. Zorunlu alanlar (* ile işaretli) doldurulduktan sonra Save butonuna basılarak kayıt sisteme eklenir.

Sık Sorulan Sorular ekran detaylarını içeren görsele aşağıda yer verilmiştir:

Sık Sorulan Sorular oluşturma konfigürasyonu için kullanılan alanlar aşağıdaki tabloda görülmektedir.

Step	Description/Function
Adım 1: FAQ Liste ekranını açın	Sol menüden Portal Management başlığını genişletin. FAQ menü öğesine tıklayın. Mevcut soruların listelendiğini doğrulayın.
Adım 2: Yeni FAQ Formunu açın	Sayfanın üst kısmındaki New FAQ butonuna tıklayın. frequently-asked-questions-update bileşeni modal form olarak açılır.
Adım 3: Temel bilgileri girin	Question alanına portal kullanıcılarının göreceği soruyu yazın. Answer alanına detaylı yanıtı Markdown desteğiyle girin (paragraflar, listeler, linkler kullanılabilir). Category alanından mevcut kategori seçin veya yeni kategori oluştur seçeneği varsa yeni bir kategori belirleyin.
Adım 4: Kaydetme	Zorunlu alanların (Question, Answer, Category) eksiksiz olduğunu kontrol edin. Save butonuna tıklayın. İstek POST /api/portal/faq (güncellemede PUT) endpointine gönderilir.

Portal Arayüzünde Görünümü

Manager’da kaydettiğiniz her soru, portal tarafındaki FAQ sayfasına otomatik olarak yansır. Portal sayfası açıldığında sistem güncel soruları çekip aşağıdaki ekranda olduğu gibi kategorilere ayırarak akordeon şeklinde gösterir.

Kategori Sekmeleri: Manager’da seçtiğiniz kategoriye göre portalda üst bölümde sekmeler (All, Eğitim, Portal vb.) otomatik oluşur.
Akordeon Yapısı: Soru üzerine tıklayan kullanıcı cevabı genişletilmiş olarak görür. Markdown ile girilen içerik kalın metin, liste, link gibi formatları korur.
Dil Desteği: Portal dilini TR/EN arasında değiştirdiğinizde sadece o dilde oluşturulan FAQ kayıtları listelenir. Farklı dilde görüntü isteniyorsa Manager’da ilgili dil için ayrı kayıt açılmalıdır.

Portal Uygulamasında Veri Akışı Nasıl Çalışır?

Manager → Portal Senkronizasyonu (Kullanıcı Perspektifi)

Manager’da Kaydet: FAQ kaydını oluşturup Active bırakarak kaydettiğiniz anda bilgi merkezi veritabanına yazılır.
Portal Sayfasını Aç: Portal kullanıcısı FAQ menüsüne girdiğinde ekran o anda kayıtlı tüm aktif soruları otomatik olarak yükler.
Kategoriler Otomatik Oluşur: Manager’da verdiğiniz kategori isimleri portalda üst sekmeler olarak görünür; kullanıcı hangi sekmeye tıklarsa sadece o kategoriye ait soruları görür.
Anında Güncelleme: Manager’da bir soruyu pasife çektiğinizde veya yanıtını değiştirdiğinizde portal sayfası yenilendiğinde yeni içerik hemen yansır. Ekstra bir yayınlama adımına gerek yoktur.
Dil Uyumu: Çok dilli portallarda her dil için ayrı kayıt eklemeyi unutmayın. Portal dili değiştirildiğinde o dile ait sorular gösterilir; diğer diller gizlenir.