Dışa aktarma sırasındaki dönüşümler
Son güncelleme: 9.10.2026API Sözleşmeleri özellikleriyle tasarlanmış bir tanım, bunları desteklemeyen bir biçimde dışa aktarıldığında tanım hedef biçime uyacak şekilde değiştirilir. Bu süreçte bir miktar ifade gücü kaybolur.
Aşağıdaki tabloda, API tanımınızı aşağıdaki belirtimlerden birinde dışa aktarırken yapılan değişiklikler açıklanmaktadır:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Desteklenmeyen özellik | Dönüştürme |
|---|---|
| Bileşenler | Bileşen, kullanıldığı her yerde kopyalanır. |
| Yanıt aralıkları ve varsayılan yanıtlar | Yanıt kaldırıldı. |
| Bearer kimlik doğrulaması ve OpenID Connect | Güvenlik şeması kaldırıldı. |
| 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ımlanan ilk uç nokta tanıma dahil edilir, diğerleri yoksayılır. |
OpenAPI Belirtimi 3.0, Hizmet koşulları alanında yalnızca URL'leri destekler. OAS 3.0'da bir tanım dışa aktarılırken, bu alan yalnızca bir URL içeriyorsa dışa aktarılır. Eğer öyle değilse, tanımın geçerliliğini sağlamak için Hizmet koşulları alanı yok sayılır.