# Birden çok sürümle çalışma

API Sözleşmeleri, yeni bir sürümde değişiklikler hazırlarken yayınlanmış bir sürümü kararlı tutabilmeniz için aynı API sözleşmesinin birden çok sürümünü yönetmenize olanak tanır.

* Yeni bir sürümde uyumluluğu bozan değişiklikler sunarken üretim ortamındaki mevcut bir API sürümünü koruyun.
* Yayımlanan sürümleri tek bir konumdan takip edin ve yönetin.
* Mevcut sürümleri etkilemeden API değişiklikleri üzerinde çalışın.

Yeni bir sürüm oluşturduğunuzda, tüm içerik yeni sürüme kopyalanır. Ardından en son sürüm, önceki sürümleri etkilemeden bağımsız olarak güncellenebilir.

Yalnızca en son sürüm düzenlenebilir ve yeni bir sürümü yalnızca bu sürümden oluşturabilirsiniz. Eski sürümler salt okunurdur.

API Sözleşmeleri ana sayfası, sahip olduğunuz tüm API'leri ve sizinle paylaşılan tüm API sürümlerini görüntüler.![API Sözleşmeleri ana sayfası.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/api-designer-homepage.png)

## Yeni bir API sürümü oluşturma

Mevcut bir API tanımının yeni bir sürümünü oluşturun.

Bilgi notu

Not:

Yalnızca en son sürümden yeni bir sürüm oluşturabilirsiniz. Eski sürümler salt okunurdur ve düzenlenemez veya yeni bir sürüm oluşturmak için kullanılamaz.

API'nin bir sahibi veya API'nin en az bir sürümünün düzenleyicisisiniz.

1. Ana sayfada, yeni bir sürümünü oluşturmak istediğiniz API'ye gidin.

   Gerekirse listeyi ada veya sahibine göre filtreleyebilirsiniz.
2. Önizleme'yi görüntülemek için en son sürümü açın, ardından Yeni bir sürüm oluştur'a tıklayın.

   ![Contacts API ve Yeni sürüm oluştur düğmesinin görünümü.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png)
3. Yeni sürümü girin.
4. Oluştur'a tıklayın.

API'nizin yeni bir sürümü, en son sürümle aynı içerikle oluşturulur. Mock ve dokümantasyon varsayılan olarak devre dışıdır.

## Qlik Catalog'a bir API sürümü yayınlama

Ortak çalışanların Qlik Catalog'da bulabilmesi için bir API sözleşmesinin bir sürümünü bir Qlik alanında yayınlayın.

API'nin bir sahibi veya API sürümünün bir düzenleyicisisiniz.

Bir sürüm yayımladığınızda, sözleşme sürümü API Sözleşmeleri içinde değiştirilemez ve salt okunur hale gelir. Değişiklik yapmak için, en son sürümden yeni bir sürüm oluşturun ve yeni sürüm üzerinde çalışmaya devam edin.

1. Ana sayfada, Önizleme'yi açmak için yayınlamak istediğiniz sürüme tıklayın, ardından Yayınla'ya tıklayın.

   ![Contacts API ve Yayınla düğmesinin görünümü.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png)
2. Yayınlama iletişim kutusunda, sürümün yayınlanmasını istediğiniz Qlik alanını seçin.
3. Sürüm önizlemesini inceleyin ve bir yayın notu girin.
4. Yayınla'ya tıklayın.

Seçilen sürüm, seçilen Qlik alanında yayınlanır ve API Sözleşmeleri içinde salt okunur hale gelir. Sözleşmeyi yeniden düzenlemeniz gerekirse önce yeni bir sürüm oluşturun.

## Bir API sürümünü silme

API'nin bir sahibisiniz.

1. Ana sayfada, silmek istediğiniz sürümün yanındaki ![Menü](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) düğmesine tıklayın ve Sil'e tıklayın.
2. Onaylamak için Sil'e tıklayın.

Seçilen sürüm silindi. Bir API'nin tamamını silmek istiyorsanız her sürümü silmeniz gerekir.

## Sürüm içeriğini içe aktarma

Mevcut bir sözleşmedeki içeriği, mevcut içeriğini değiştirerek veya birleştirerek bir API sürümüne aktarın.

API'nin bir sahibi veya API sürümünün bir düzenleyicisisiniz.

Yeni bir sürüm oluşturmadan harici bir sözleşme dosyasından bir sürümü güncellemek için bu özelliği kullanın. Sürüm tanımlayıcısı, içe aktarma işlemi boyunca korunur.

Bu, şundan farklıdır [bir tanımı içe aktarma](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/APIDesigner/ImportingDefinition.htm "Mevcut bir API tanımını API Contracts'a içe aktarın."); bu da API Sözleşmeleri'nde yeni bir API oluşturur.

1. Güncellemek istediğiniz sürüm için Sürüm içeriğini içe aktar'ı açın.

   Bu işlem salt okunur bir sürüm için kullanılamaz.

   Bu eyleme aşağıdaki konumlardan erişebilirsiniz:
   * Ana sayfada, sürümün yanındaki ![Menü](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) simgesine tıklayın ve Sürüm içeriğini içe aktar seçeneğine tıklayın.

     ![Menü düğmesindeki Sürüm içeriğini içe aktar seçeneği.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-2.png)
   * Sürümün Önizleme bölümünde, ![Menü](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) &gt; Sürüm içeriğini içe aktar öğesine tıklayın.

     ![Sürüm Ayrıntıları Görünümü](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-3.png)
   * Sürüm düzenleyicisinde Düzenle &gt; Sürüm içeriğini içe aktar öğesine tıklayın.

     ![Sürüm düzenleyicideki sürüm içeriğini içe aktarma seçeneği.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content.png)
2. İçe aktarılacak sözleşme için bir biçim ve kaynak seçin.

   Yerel bir dosyadan, bir URL'den veya doğrudan iletişim kutusuna yapıştırdığınız bir metinden içe aktarabilirsiniz.
3. Davranış altında, içe aktarılan içeriğin nasıl uygulanacağını seçin.
   * Değiştir: mevcut tüm içeriğin üzerine içe aktarılan sözleşmeyi yazar. API adı, sürüm tanımlayıcısı ve belirtim sürümü korunur.
   * Birleştir: içe aktarılan içeriği mevcut sürüm içeriğiyle birleştirir. API adı ve sürüm tanımlayıcısı korunur. İçe aktarılan bir öğe, mevcut bir öğeyle aynı ada sahipse içe aktarılan öğe bir \_merge son ekiyle yeniden adlandırılır (örneğin, User\_merge). Yinelenen temel URL'ler ve medya türleri atlanır.

   ![Sürüm içeriğini içe aktarma iletişim kutusu.](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-dialobox.png)
4. İçe Aktar'a tıklayın.

Sürüm düzenleyici, güncellenmiş içerik uygulanmış olarak açılır.