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

> API yapılandırmalarınızı farklı ortamlar (Development, Test, Staging, Production) arasında güvenli ve kontrollü bir şekilde taşıyabilir, ortam değişkenlerini otomatik eşleştirebilir ve onay mekanizmalarıyla yönetebilirsiniz.

## Neden API Promotion?

API yaşam döngüsünde API'ler genellikle birden fazla ortamdan geçer. Her ortam farklı backend adresleri, farklı güvenlik yapılandırmaları ve farklı [ortam değişkenleri](/tr/concepts/temel-kavramlar/environment-variable) kullanabilir. Bu geçişleri manuel olarak yapmak hem zaman alıcıdır hem de hata yapma riskini artırır.

API Promotion ile:

* **Tutarlılık**: Kaynak ortamdaki API yapılandırmasını olduğu gibi hedef ortama aktarabilirsiniz
* **Otomatik değişken eşleştirme**: [Ortam değişkenlerini](/tr/concepts/temel-kavramlar/environment-variable) (backend adresi, API anahtarı vb.) hedef ortamın değerleriyle otomatik eşleştirebilirsiniz
* **Karşılaştırma ve fark analizi**: Aktarım öncesinde kaynak ve hedef arasındaki farkları görebilirsiniz
* **Onay mekanizması**: Kritik ortamlara (ör. Production) aktarım için zorunlu onay süreçleri tanımlayabilirsiniz
* **İzlenebilirlik**: Tüm aktarım geçmişini adım adım takip edebilirsiniz

## Desteklenen API Tipleri

API Promotion aşağıdaki API tiplerini destekler:

| Tip                                                             | Açıklama                                                                                                  |
| --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **[API Proxy](/tr/concepts/temel-kavramlar/api-proxy-nedir)**   | Standart API Proxy aktarımı. Creator bağımlılıkları (DB-2-API, Script-2-API) varsa otomatik tespit edilir |
| **DB-2-API**                                                    | Veritabanından oluşturulan API'lerin Creator tanımını bağımsız olarak aktarabilirsiniz                    |
| **Script-2-API**                                                | Script tabanlı API'lerin Creator tanımını bağımsız olarak aktarabilirsiniz                                |
| **Mock API**                                                    | Mock API Creator tanımını bağımsız olarak aktarabilirsiniz                                                |
| **[Proxy Group](/tr/concepts/temel-kavramlar/api-proxy-group)** | Bir Proxy Group'u, içindeki tüm proxy'ler ve bağımlılıklarıyla birlikte aktarabilirsiniz                  |

<Warning>
  Connector türündeki API Proxy'ler promotion için desteklenmemektedir.
</Warning>

## Genel İş Akışı

API Promotion üç ana adımdan oluşur:

### 1. Instance Tanımlama

Hedef Apinizer ortamlarını (Development, Test, Staging, Production) birer **Instance** olarak tanımlarsınız. Her instance için bağlantı bilgileri, onay gereksinimleri ve bildirim alıcıları yapılandırılır.

<img src="https://mintcdn.com/apinizer/1yFCZZQUbO1Sf_g6/images/promotion/instance-new.png?fit=max&auto=format&n=1yFCZZQUbO1Sf_g6&q=85&s=1676b2a93f7f25bb1ef87ba08c7e8dae" alt="mapping-create" width="1000" data-path="images/promotion/instance-new.png" />

### 2. API Mapping Oluşturma

Kaynak ortamdaki bir API ile hedef ortamdaki karşılığını eşleştiren bir **Mapping** tanımlarsınız. Bu adımda:

* Kaynak ve hedef API'yi seçersiniz (veya hedef ortamda yeni API oluşturursunuz)
* [Ortam değişkenlerini](/tr/concepts/temel-kavramlar/environment-variable) eşleştirirsiniz
* Gerekli dönüşüm kurallarını tanımlarsınız
* Aktarım öncesi ön kontrolleri çalıştırırsınız

<Info>
  Source ve Target Project alanlarında, instance oluşturma işlemi sırasında kullanılan token'ın sahibi olan kullanıcının erişim yetkisine sahip olduğu projeler listelenir.
</Info>

<img src="https://mintcdn.com/apinizer/1yFCZZQUbO1Sf_g6/images/promotion/new-map.png?fit=max&auto=format&n=1yFCZZQUbO1Sf_g6&q=85&s=e3b57c1a9ed97e9d1368cf258b1a11b2" alt="mapping-create" width="1000" data-path="images/promotion/new-map.png" />

### 3. Çalıştırma (Execution)

Mapping hazır olduğunda **Execute** işlemiyle aktarımı başlatırsınız. Onay gerekiyorsa süreç onay bekler; onay sonrası hemen veya planlanmış bir tarihte çalıştırılabilir.

<img src="https://mintcdn.com/apinizer/1yFCZZQUbO1Sf_g6/images/promotion/execution-new.png?fit=max&auto=format&n=1yFCZZQUbO1Sf_g6&q=85&s=c784db34f4bedd31158556c068faa8a3" alt="mapping-create" width="1000" data-path="images/promotion/execution-new.png" />

## Bağımlılık Yönetimi

API Promotion, aktarılacak API'nin bağımlılıklarını otomatik olarak tespit eder ve bunların da hedef ortamda eşleştirilmesini zorunlu kılar:

* **DB-2-API** üzerinden oluşturulan API Proxy'ler: Creator + Veritabanı Bağlantısı zorunlu olarak birlikte taşınır
* **Script-2-API** ve **Mock API** üzerinden oluşturulan API Proxy'ler: Sadece Creator tanımı zorunlu olarak taşınır
* **Manuel oluşturulan** API Proxy'ler: Bağımlılık yoktur, sadece proxy tanımı taşınır
* **Proxy Group** aktarımında: Önce grup ayarları, ardından her bir proxy ve bağımlılıkları sırayla taşınır

## Sonraki Adımlar

<CardGroup cols={2}>
  <Card title="Instance Yönetimi" icon="server" href="/tr/admin/api-promotion/instance-yonetimi">
    Hedef ortamları tanımlayın ve yapılandırın
  </Card>

  <Card title="API Mapping Oluşturma" icon="arrows-left-right" href="/tr/admin/api-promotion/api-mapping-olusturma">
    Kaynak-hedef API eşleştirmelerini oluşturun
  </Card>

  <Card title="Çalıştırma ve İzleme" icon="play" href="/tr/admin/api-promotion/calistirma-ve-izleme">
    Aktarımları çalıştırın ve takip edin
  </Card>

  <Card title="En İyi Uygulamalar" icon="lightbulb" href="/tr/admin/api-promotion/en-iyi-uygulamalar">
    Verimli kullanım için öneriler
  </Card>
</CardGroup>