Dışa aktarma sırasında dönüşümler
API Designer özellikleriyle tasarlanmış bir tanımı, bunları desteklemeyen bir biçimde dışa aktarırken, tanım hedef biçime uyacak şekilde değiştirilir. Bu süreçte bazı ifade yetenekleri kaybolur.
Aşağıdaki tablo, aşağıdaki belirtimlerden birinde dışa aktarma yaparken API tanımınızda yapılan değişiklikleri açıklamaktadır:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Desteklenmeyen özellik | Dönüşüm |
|---|---|
| Bileşenler | Bileşen, kullanıldığı her yere kopyalanır. |
| Yanıt aralıkları ve varsayılan yanıtlar | Yanıt kaldırılır. |
| Taşıyıcı (Bearer) kimlik doğrulaması ve OpenID Connect | Güvenlik şeması kaldırılır. |
| allOf kombinasyonları | Kombinasyon, kullanılan tüm türlerin tüm özelliklerini içeren bir nesneyle değiştirilir. |
| anyOf ve oneOf kombinasyonları | Kombinasyon boş bir nesneyle değiştirilir. |
| Birden çok uç nokta | Yayınlanan ilk uç nokta tanıma dahil edilir, diğerleri yoksayılır. |
OpenAPI Specification 3.0, yalnızca Hizmet şartları alanında URL'leri destekler. OAS 3.0'da bir tanımı dışa aktarırken, bu alan yalnızca bir URL içeriyorsa dışa aktarılır. İçermiyorsa, tanımın geçerliliğini sağlamak için Hizmet şartları alanı yoksayılır.