Преобразования при экспорте
Последнее обновление: 20.10.2026При экспорте определения, созданного с использованием возможностей API Contracts, в формат, который их не поддерживает, определение изменяется в соответствии с целевым форматом. В процессе теряется некоторая выразительность.
В приведенной ниже таблице описаны изменения, вносимые в определение вашего API при экспорте в одну из следующих спецификаций:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Неподдерживаемая функциональность | Преобразование |
|---|---|
| Компоненты | Компонент копируется во всех местах, где он используется. |
| Диапазоны ответов и ответы по умолчанию | Ответ удален. |
| Аутентификация Bearer и OpenID Connect | Схема безопасности удалена. |
| Комбинации allOf | Комбинация заменяется объектом, содержащим все свойства всех используемых типов. |
| Комбинации anyOf и oneOf | Комбинация заменяется пустым объектом. |
| Несколько конечных точек | Первая опубликованная конечная точка включается в определение, остальные игнорируются. |
Спецификация OpenAPI 3.0 поддерживает только URL-адреса в поле Условия использования. При экспорте определения в OAS 3.0 это поле экспортируется только в том случае, если оно содержит URL-адрес. В противном случае поле Условия обслуживания игнорируется для обеспечения корректности определения.