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

# API Designer

> API Designer (API Tasarımcısı), Apinizer platformunda spec first yaklaşımı ile API tasarımı, dokümantasyonu ve spesifikasyonu için araçlar sağlayan bileşendir. OpenAPI/Swagger spesifikasyonu oluşturma, düzenleme ve bu spesifikasyondan API Proxy oluşturma imkânı sunar.

## API Designer Kavramı

API Designer, **spec first** yaklaşımı ile API geliştirme sürecini destekler. Bu yaklaşımda önce OpenAPI/Swagger spesifikasyonu oluşturulur, sonra bu spesifikasyondan API Proxy oluşturulur.

<CardGroup cols={2}>
  <Card title="Spec First Yaklaşımı" icon="file-code">
    OpenAPI/Swagger spesifikasyonu önce oluşturulur

    API tasarımı spesifikasyon ile başlar.
  </Card>

  <Card title="Spesifikasyon Düzenleme" icon="pencil">
    OpenAPI/Swagger spesifikasyonu düzenlenir

    YAML/JSON formatında spesifikasyon oluşturma ve düzenleme.
  </Card>

  <Card title="Otomatik Dokümantasyon" icon="book">
    Spesifikasyondan otomatik dokümantasyon oluşturulur

    OpenAPI spec'ten dokümantasyon üretilir.
  </Card>

  <Card title="API Proxy Oluşturma" icon="network-wired">
    Spesifikasyondan API Proxy oluşturulur

    OpenAPI spec'ten API Proxy oluşturma.
  </Card>
</CardGroup>

## API Designer Özellikleri

### OpenAPI/Swagger Spesifikasyonu

Spec first yaklaşımında OpenAPI/Swagger spesifikasyonu oluşturma ve düzenleme:

<AccordionGroup>
  <Accordion title="OpenAPI Editor">
    * OpenAPI/Swagger editor
    * YAML/JSON düzenleme
    * Validation
    * Syntax kontrolü
  </Accordion>

  <Accordion title="Schema Tasarımı">
    * JSON Schema tasarımı
    * XML Schema tasarımı
    * Data model tasarımı
    * Request/Response schema'ları
  </Accordion>

  <Accordion title="Endpoint Tasarımı">
    * Endpoint tanımlama
    * HTTP method belirleme
    * Path parametreleri
    * Query parametreleri
  </Accordion>
</AccordionGroup>

### Dokümantasyon Oluşturma

OpenAPI/Swagger spesifikasyonundan otomatik dokümantasyon oluşturma:

<CardGroup cols={2}>
  <Card title="Otomatik Dokümantasyon" icon="wand-magic-sparkles">
    OpenAPI spec'ten otomatik dokümantasyon oluşturulur

    * Spesifikasyondan dokümantasyon üretimi
    * Markdown desteği
    * Custom dokümantasyon ekleme
  </Card>

  <Card title="Dokümantasyon Önizleme" icon="eye">
    Oluşturulan dokümantasyon önizlenebilir

    * Gerçek zamanlı önizleme
    * Portal görünümü simülasyonu
    * Dokümantasyon kalitesi kontrolü
  </Card>

  <Card title="Dokümantasyon Export" icon="download">
    Dokümantasyon farklı formatlarda export edilebilir

    * PDF export
    * HTML export
    * Markdown export
  </Card>
</CardGroup>

## API Designer Kullanım Senaryoları

Spec first yaklaşımı ile API geliştirme senaryoları:

<CardGroup cols={2}>
  <Card title="Spec First API Geliştirme" icon="file-code">
    1. OpenAPI/Swagger spesifikasyonu oluşturma
    2. Endpoint'leri ve schema'ları tanımlama
    3. Spesifikasyonu doğrulama
    4. Spesifikasyondan API Proxy oluşturma
    5. Otomatik dokümantasyon oluşturma
    6. API Portal'da yayınlama
  </Card>

  <Card title="Mevcut API Dokümantasyonu" icon="book">
    1. Mevcut API'den OpenAPI spec oluşturma
    2. Spesifikasyonu düzenleme ve güncelleme
    3. Dokümantasyonu iyileştirme
    4. Örnekler ve açıklamalar ekleme
    5. Portal'da yayınlama
  </Card>
</CardGroup>

## API Designer ve API Manager İlişkisi

API Designer, spec first yaklaşımı ile API Manager'a entegre çalışır. İşleyiş akışı:

```
API Designer
   │
   │ OpenAPI/Swagger Spec
   │ (Spec First)
   │
   ▼
API Manager
   │
   │ Spec'ten API Proxy Oluşturma
   │ Konfigürasyon
   │
   ▼
API Gateway
```

<CardGroup cols={4}>
  <Card title="1. Spec Oluşturma" icon="file-code">
    API Designer'da OpenAPI/Swagger spesifikasyonu oluşturulur

    Spec first yaklaşımı ile API tasarımı spesifikasyon ile başlar.
  </Card>

  <Card title="2. Spec Doğrulama" icon="check-circle">
    Spesifikasyon doğrulanır ve kontrol edilir

    OpenAPI standartlarına uygunluk kontrolü yapılır.
  </Card>

  <Card title="3. API Proxy Oluşturma" icon="network-wired">
    API Manager'da spesifikasyondan API Proxy oluşturulur

    OpenAPI spec'ten otomatik olarak API Proxy oluşturulur.
  </Card>

  <Card title="4. Dokümantasyon ve Deployment" icon="rocket">
    Dokümantasyon oluşturulur ve API deploy edilir

    Otomatik dokümantasyon üretilir ve API Gateway'e deploy edilir.
  </Card>
</CardGroup>

<Info>
  API Designer ve API Manager arasındaki bu entegrasyon, spec first yaklaşımı ile API tasarımından deployment'a kadar kesintisiz bir süreç sağlar. Spesifikasyon önce oluşturulur, sonra bu spesifikasyondan API Proxy ve dokümantasyon otomatik olarak üretilir.
</Info>

## API Designer Avantajları

Spec first yaklaşımının sağladığı avantajlar:

<CardGroup cols={2}>
  <Card title="Spec First Yaklaşımı" icon="file-code">
    * API tasarımı spesifikasyon ile başlar
    * Standart OpenAPI/Swagger formatı
    * Kod yazmadan API tasarımı
  </Card>

  <Card title="Otomatik Üretim" icon="wand-magic-sparkles">
    * Spesifikasyondan API Proxy oluşturma
    * Otomatik dokümantasyon üretimi
    * Tutarlı API yapısı
  </Card>

  <Card title="Standart Uyumluluk" icon="check-circle">
    * OpenAPI/Swagger standartlarına uyum
    * Interoperability
    * Tool desteği
  </Card>

  <Card title="Güncel Dokümantasyon" icon="book">
    * Spesifikasyondan otomatik dokümantasyon
    * Dokümantasyon-spesifikasyon senkronizasyonu
    * Portal entegrasyonu
  </Card>
</CardGroup>

## Sonraki Adımlar

<CardGroup cols={2}>
  <Card title="API Creator" icon="wand-magic-sparkles" href="/tr/concepts/temel-bilesenler/api-creator">
    API Creator bileşenini öğrenin
  </Card>

  <Card title="API Portal" icon="globe" href="/tr/concepts/temel-bilesenler/api-portal">
    API Portal bileşenini öğrenin
  </Card>

  <Card title="API Tasarımı" icon="pencil" href="/tr/develop/api-tasarimi/data-models">
    API tasarım kılavuzu
  </Card>

  <Card title="OpenAPI" icon="file-code" href="/tr/develop/api-tasarimi/spec-designer">
    OpenAPI kullanımı
  </Card>
</CardGroup>