> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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. Hem İngilizce hem Türkçe dillerinde soru-cevap içerikleri tanımlayarak portalın kullanıcı deneyimini zenginleştirir. API tüketicileri portal üzerinden sıkça merak edilen bilgilere hızlıca erişebilir. Kullanıcıların API Portal'ı, API kullanım yöntemlerini veya genel kavramları daha iyi anlamalarına yardımcı olur.

## 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:**

<Frame caption="Sık Sorulan Sorular Liste Ekranı">
  <img src="https://mintcdn.com/apinizer/cFKLnK4_FEpze_C9/images/portal/siklikla_sorulan_sorular_liste.png?fit=max&auto=format&n=cFKLnK4_FEpze_C9&q=85&s=ca150b438095587406b42b1030a4c027" alt="Sık Sorulan Sorular Liste Ekranı" width="1100" data-path="images/portal/siklikla_sorulan_sorular_liste.png" />
</Frame>

### Liste Ekranı Alanları

| 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.                                         |

<Info>
  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](/tr/api-portal/api-portal-ayarlari) aktif hale getirilmişse, 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.).
</Info>

## 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:**

<Frame caption="Sık Sorulan Sorular Form Ekranı">
  <img src="https://mintcdn.com/apinizer/cFKLnK4_FEpze_C9/images/portal/siklikla_sorulan_sorular_form.png?fit=max&auto=format&n=cFKLnK4_FEpze_C9&q=85&s=f6218ce87324a29b3a0868aed8a8166b" alt="Sık Sorulan Sorular Form Ekranı" width="1100" data-path="images/portal/siklikla_sorulan_sorular_form.png" />
</Frame>

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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.

<Frame caption="Portal Arayüzünde FAQ Görünümü">
  <img src="https://mintcdn.com/apinizer/cFKLnK4_FEpze_C9/images/portal/siklikla_sorulan_sorular_portal.png?fit=max&auto=format&n=cFKLnK4_FEpze_C9&q=85&s=2a39cbe7e649d54f31823547de32b2a2" alt="Portal Arayüzünde FAQ Görünümü" width="1100" data-path="images/portal/siklikla_sorulan_sorular_portal.png" />
</Frame>

* **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)**

<Steps>
  <Step title="Manager'da Kaydet">
    FAQ kaydını oluşturup `Active` bırakarak kaydettiğiniz anda bilgi merkezi veritabanına yazılır.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>