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

# En İyi Uygulamalar

> API Promotion işlemlerini verimli ve güvenli bir şekilde yürütmek için ortam stratejisi, değişken yönetimi, onay akışı ve dönüşüm kuralları konusunda önerilen yaklaşımları öğrenebilirsiniz.

## Ortam Stratejisi

### Instance Tipleri ile Ortam Ayrımı

Her ortam için uygun instance tipini seçin. Bu hem görsel ayrım sağlar hem de onay mekanizmasını doğru seviyede uygulamanıza yardımcı olur.

| Ortam       | Önerilen Instance Tipi | Onay Gerekli mi?     |
| ----------- | ---------------------- | -------------------- |
| Development | Development            | Hayır                |
| Test        | Test                   | Hayır veya Opsiyonel |
| Staging     | Staging                | Evet                 |
| Production  | Production             | Evet                 |

<Tip>
  Production ortamına yapılacak tüm aktarımlar için onay mekanizmasını aktifleştirin. Bu, yanlışlıkla yapılabilecek aktarımları önler.
</Tip>

### Aşamalı Aktarım

API'lerinizi doğrudan Development'tan Production'a aktarmak yerine aşamalı bir yaklaşım izleyin:

```
Development → Test → Staging → Production
```

Her aşamada aktarılan yapılandırmanın doğru çalıştığını doğruladıktan sonra bir sonraki ortama geçin.

## [Ortam Değişkeni](/tr/concepts/temel-kavramlar/environment-variable) Yönetimi

### Tutarlı Değişken İsimlendirme

Tüm ortamlarda aynı değişken anahtarlarını kullanın. Otomatik eşleştirme, anahtar adlarının birebir eşleşmesine dayanır.

**Doğru yaklaşım:**

* Development: `BACKEND_URL = https://dev-api.example.com`
* Production: `BACKEND_URL = https://api.example.com`

**Yanlış yaklaşım:**

* Development: `DEV_BACKEND_URL = https://dev-api.example.com`
* Production: `PROD_BACKEND_URL = https://api.example.com`

### Eksik Değişken Kontrolü

Mapping oluştururken ortam değişkeni eşleştirme adımında eksik değişkenleri kontrol edin. Hedef ortamda eksik değişken varsa, aktarım öncesinde bu değişkenleri hedef ortamda tanımlayın.

<Warning>
  Eksik ortam değişkenleri, aktarılan API'nin hedef ortamda çalışma zamanında hata almasına neden olabilir.
</Warning>

## Find & Replace Kuralları

### Ne Zaman Kullanılmalı?

Find & Replace kurallarını, ortam değişkenleriyle yönetilmeyen ancak ortamlar arasında farklılık gösteren değerler için kullanın:

* Backend adresleri (ortam değişkeni kullanılmıyorsa)
* Sertifika referansları
* Zaman aşımı değerleri
* Ortama özgü yapılandırma parametreleri

### JSONPath ve Düz Metin

* **JSONPath**: Belirli bir yapılandırma alanını hedeflemek için kullanın. Daha kesin ve güvenlidir
* **Düz metin**: API tanımı genelinde bir metin değerini değiştirmek için kullanın. Beklenmedik yerlerdeki eşleşmelere dikkat edin

<Tip>
  Mümkün olduğunca JSONPath ifadelerini tercih edin. Düz metin değiştirme, API tanımının beklenmedik bölümlerinde de eşleşme yapabilir.
</Tip>

## Ön Kontrol (Pre-Flight Check)

### Her Aktarım Öncesinde Çalıştırın

Ön kontroller, aktarım öncesinde olası sorunları tespit etmenizi sağlar. Özellikle:

* Hedef ortam bağlantısının aktif olduğunu doğrular
* API versiyon çakışmalarını kontrol eder
* Yetki sorunlarını önceden tespit eder

### Uyarıları Görmezden Gelmeyin

Ön kontrol sonucunda **Uyarı** durumundaki maddeler, aktarımı engellemez ancak potansiyel sorunlara işaret eder. Bu uyarıları değerlendirip gerekli düzeltmeleri yapmanız önerilir.

## Onay Akışı

### Onaylayıcı Seçimi

* Production ortamı için en az iki onaylayıcı tanımlayın
* Onaylayıcıları, hedef ortamın sorumluları arasından seçin

### Bildirim Alıcıları

* Çalıştırma durumundan haberdar olması gereken kişileri bildirim alıcısı olarak ekleyin
* Özellikle başarısız çalıştırmalarda hızlı müdahale için e-posta bildirimleri yapılandırın

## Genel Öneriler

<AccordionGroup>
  <Accordion title="Mapping'leri güncel tutun">
    Kaynak API'de değişiklik yapıldığında, mapping'in karşılaştırma sonuçlarını yenileyerek farkları gözden geçirin. Bu sayede beklenmedik değişikliklerin hedef ortama aktarılmasını önlersiniz.
  </Accordion>

  <Accordion title="Çalıştırma geçmişini takip edin">
    Çalıştırma listesindeki istatistikleri düzenli olarak kontrol edin. Başarısız çalıştırmaların nedenlerini araştırın ve tekrarlayan hataları ortadan kaldırın.
  </Accordion>

  <Accordion title="Hariç tutulan alanları doğru yapılandırın">
    Ortama özgü alanları (kimlik numaraları, tarihler, kullanıcı bilgileri) hariç tutun. Sistem varsayılanları çoğu durumu karşılar, ancak özel alanlarınız varsa bunları kullanıcı tanımlı alan olarak ekleyin.
  </Accordion>

  <Accordion title="Proxy Group aktarımlarında dikkatli olun">
    Proxy Group aktarımı, grup içindeki tüm proxy'leri ve bağımlılıkları kapsar. Büyük gruplarda aktarım süresi uzayabilir. Grupları parçalara ayırmak yerine, bütünlüğü korumak için tek seferde aktarmayı tercih edin.
  </Accordion>

  <Accordion title="Bağlantı sağlığını izleyin">
    Instance listesindeki sağlık durumlarını düzenli kontrol edin. Sorunlu bir instance'a yapılacak aktarım başarısız olacaktır.
  </Accordion>
</AccordionGroup>