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

API Designer, API yaşam döngünüzü yönetmenize yardımcı olmak için aynı API tanımının birkaç sürümüyle çalışmanıza olanak tanır. Şunları yapabilirsiniz:

Yeni bir sürümde önemli veya köklü değişiklikler sunarken üretimdeki mevcut bir API sürümünü koruyabilirsiniz.
Yayınlanan sürümler üzerinde görünürlük ve kontrol elde edebilirsiniz.
Bir API'de değişiklik tasarlarken esneklik kazanabilirsiniz.

Bir API'nin yeni bir sürümünü oluşturduğunuzda, tüm içerik yeni sürüme kopyalanır ve ardından her sürüm diğerlerini etkilemeden bağımsız olarak değiştirilebilir.

API Designer ana sayfası, sahip olduğunuz tüm API'leri ve sizinle paylaşılan tüm API sürümlerini görüntüler.

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

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

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

Ana sayfada, yeni bir sürümünü oluşturmak istediğiniz API'ye gidin.
Gerekirse listeyi ada veya sahibe göre filtreleyebilirsiniz.
Kopyalamak istediğiniz sürümün yanındaki düğmesine tıklayın ve <version> sürümünden yeni bir sürüm oluştur seçeneğine tıklayın.
Yeni sürümü girin.
Oluştur'a tıklayın.

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

Bir API sürümünü silme

API'nin sahibisiniz.

Ana sayfada, silmek istediğiniz sürümün yanındaki düğmesine tıklayın ve Sil'e tıklayın.
Onaylamak için Sil'e tıklayın.

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

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

Mevcut bir sözleşmeden bir API sürümüne içerik aktararak mevcut içeriğini değiştirin veya birleştirin.

API'nin sahibi veya API sürümünün 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 boyunca korunur.

Bu, API Designer içinde yeni bir API oluşturan bir tanımı içe aktarma işleminden farklıdır.

Güncellemek istediğiniz sürüm için Sürüm içeriğini içe aktar seçeneğini açın.
Bu eyleme aşağıdaki konumlardan erişebilirsiniz:
- Ana sayfada, sürümün yanındaki menü düğmesine tıklayın ve Sürüm içeriğini içe aktar seçeneğine tıklayın.
- Ana sayfada, ayrıntı bölmesini açmak için sürümü seçin, ardından Sürüm içeriğini içe aktar seçeneğine tıklayın.
- Sürüm düzenleyicide, Düzenle > Sürüm içeriğini içe aktar seçeneğine tıklayın.
İç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 metinden içe aktarabilirsiniz.
Davranış altında, içe aktarılan içeriğin nasıl uygulanacağını seçin.
- Değiştir: tüm mevcut 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 _merge sonekiyle yeniden adlandırılır (örneğin, User_merge). Yinelenen temel URL'ler ve medya türleri atlanır.
İçe Aktar'a tıklayın.

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

Bu sayfa size yardımcı oldu mu?

Bu sayfa veya içeriği ile ilgili bir sorun; bir yazım hatası, eksik bir adım veya teknik bir hata bulursanız lütfen bize bildirin!

Geri bildiriminizi buradan iletin