> ## 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 Proxy Tasarımı

> API Proxy'nin metot/endpoint ve veri tiplerinin tanımlarını yönetebilirsiniz. Yüklenerek kullanıma açılan bir API Proxy'nin API Tanım Dosyası bu tanımlamalar kullanılarak çalışma zamanında oluşturulur.

## Tasarım Sekmesi Kavramı

Tasarım sekmesi, API Proxy konfigürasyonunda spec first yaklaşımı ile API tasarımı, dokümantasyonu ve spesifikasyonu için araçlar sağlar. Bu sekmede seçilen API Proxy'nin metot/endpoint ve veri tiplerinin tanımları yönetilir. Yüklenerek kullanıma açılan bir API Proxy'nin API Tanım Dosyası bu tanımlamalar kullanılarak çalışma zamanında oluşturulur.

<img src="https://mintcdn.com/apinizer/brWu4H3JyK0OgbJV/images/develop/api-proxy-konfigurasyonu/tasarim-sekmesi.png?fit=max&auto=format&n=brWu4H3JyK0OgbJV&q=85&s=c78bb01a7f6854764e2ab8bc560228dd" alt="Tasarım Sekmesi" width="1000" height="667" data-path="images/develop/api-proxy-konfigurasyonu/tasarim-sekmesi.png" />

<CardGroup cols={2}>
  <Card title="Spec First Yaklaşımı" icon="file-code">
    OpenAPI/Swagger spesifikasyonu ile API tasarımı

    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 Tanım Dosyası" icon="network-wired">
    Çalışma zamanında API Tanım Dosyası oluşturulur

    Tanımlamalar kullanılarak API Tanım Dosyası üretilir.
  </Card>
</CardGroup>

<Info>
  Tasarım sekmesinin içeriği ve kullanımı, Genel Bakış bölümünde birkaç detay verinin istenmiyor olması dışında [Spec Tasarım Editörü](/tr/develop/api-tasarimi/spec-designer) arayüzü ile aynıdır.
</Info>

<Warning>
  Tasarım sekmesi yalnızca **Swagger 2.x**, **OpenAPI/Swagger 3.0.x** ve **No-Spec API** tipindeki API Proxy'ler için kullanılabilir.
</Warning>

## Tasarım Sekmesi Ö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>

### Metot ve Veri Tipi Tanımları

API Proxy'nin metot/endpoint ve veri tiplerinin tanımlarını yönetme:

<CardGroup cols={2}>
  <Card title="Metot Tanımları" icon="code">
    API Proxy metotlarının tanımları yönetilir

    * HTTP metotları (GET, POST, PUT, DELETE vb.)
    * Endpoint path'leri
    * Parametre tanımları
  </Card>

  <Card title="Veri Tipi Tanımları" icon="database">
    Veri tiplerinin tanımları yönetilir

    * Request/Response modelleri
    * Schema tanımları
    * Veri yapıları
  </Card>

  <Card title="API Tanım Dosyası Oluşturma" icon="file-code">
    Çalışma zamanında API Tanım Dosyası oluşturulur

    * Tanımlamalardan otomatik üretim
    * OpenAPI/Swagger formatı
    * Portal entegrasyonu
  </Card>
</CardGroup>

## Tasarım Sekmesi Kullanım Senaryoları

Spec first yaklaşımı ile API Proxy konfigürasyonu senaryoları:

<CardGroup cols={2}>
  <Card title="Spec First API Proxy Konfigürasyonu" icon="file-code">
    1. Tasarım sekmesinde OpenAPI/Swagger spesifikasyonu oluşturma
    2. Endpoint'leri ve schema'ları tanımlama
    3. Spesifikasyonu doğrulama
    4. API Tanım Dosyası oluşturma
    5. API Proxy'yi yükleme ve kullanıma açma
  </Card>

  <Card title="Mevcut API Proxy Güncelleme" icon="pencil">
    1. Mevcut API Proxy'nin spesifikasyonunu düzenleme
    2. Metot ve veri tipi tanımlarını güncelleme
    3. Spesifikasyonu doğrulama
    4. Güncellenmiş API Tanım Dosyası oluşturma
    5. Değişiklikleri kaydetme
  </Card>
</CardGroup>

## Tasarım Sekmesi ve Spec Tasarım Editörü İlişkisi

Tasarım sekmesi, Spec Tasarım Editörü ile aynı arayüzü ve özellikleri kullanır. İşleyiş akışı:

```
API Proxy Konfigürasyonu
   │
   │ Tasarım Sekmesi
   │ (Spec First)
   │
   ▼
Spec Tasarım Editörü
   │
   │ OpenAPI/Swagger Spec
   │ Metot/Endpoint Tanımları
   │ Veri Tipi Tanımları
   │
   ▼
API Tanım Dosyası
   │
   │ Çalışma Zamanında Oluşturma
   │
   ▼
API Proxy Deployment
```

<CardGroup cols={4}>
  <Card title="1. Spesifikasyon Oluşturma" icon="file-code">
    Tasarım sekmesinde OpenAPI/Swagger spesifikasyonu oluşturulur

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

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

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

  <Card title="3. Metot/Endpoint Tanımlama" icon="code">
    Metot ve endpoint tanımları yapılır

    HTTP metotları ve path'ler tanımlanır.
  </Card>

  <Card title="4. API Tanım Dosyası Oluşturma" icon="rocket">
    Çalışma zamanında API Tanım Dosyası oluşturulur

    Tanımlamalardan otomatik olarak API Tanım Dosyası üretilir.
  </Card>
</CardGroup>

<Info>
  Tasarım sekmesi ve Spec Tasarım Editörü 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 Tanım Dosyası otomatik olarak üretilir.
</Info>

## Tasarım Sekmesi 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">
    * Tanımlamalardan API Tanım Dosyası 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="Genel Bilgi Sekmesi" icon="info-circle" href="/tr/develop/api-proxy-konfigurasyonu/overview">
    API Proxy genel bilgileri
  </Card>

  <Card title="Settings" icon="gear" href="/tr/develop/api-proxy-konfigurasyonu/settings">
    API Proxy ayarları
  </Card>

  <Card title="Endpoint Konfigürasyonu" icon="link" href="/tr/develop/api-proxy-konfigurasyonu/endpoint-konfigurasyonu">
    REST endpoint konfigürasyonu
  </Card>

  <Card title="SOAP Metod Konfigürasyonu" icon="code" href="/tr/develop/api-proxy-konfigurasyonu/soap-metod-konfigurasyonu">
    SOAP metod konfigürasyonu
  </Card>

  <Card title="Spec Tasarım Editörü" icon="pencil" href="/tr/develop/api-tasarimi/spec-designer">
    Spec Tasarım Editörü detayları
  </Card>

  <Card title="API Designer" icon="wand-magic-sparkles" href="/tr/concepts/temel-bilesenler/api-designer">
    API Designer bileşenini öğrenin
  </Card>
</CardGroup>