Transformacje podczas operacji eksportować
Ostatnia aktualizacja: 20.10.2026Podczas eksportowania definicji zaprojektowanej z użyciem funkcji API Contracts w formacie, który ich nie obsługuje, definicja jest modyfikowana w celu dostosowania jej do formatu docelowego. Część ekspresyjności zostaje utracona w tym procesie.
W poniższej tabeli opisano modyfikacje wprowadzone do Twojej definicji API podczas eksportowania w jednej z następujących specyfikacji:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Nieobsługiwana cecha | Transformacja |
|---|---|
| Składniki | Komponent jest kopiowany w każdym miejscu, w którym jest używany. |
| Zakresy odpowiedzi i domyślne odpowiedzi | Odpowiedź została usunięta. |
| Uwierzytelnianie Bearer i OpenID Connect | Schemat zabezpieczeń został usunięty. |
| kombinacje allOf | Kombinacja zostaje zastąpiona obiektem zawierającym wszystkie właściwości wszystkich użytych typów. |
| kombinacje anyOf i oneOf | Kombinacja zostaje zastąpiona pustym obiektem. |
| Wiele punktów końcowych | Pierwszy opublikowany punkt końcowy jest uwzględniony w definicji, pozostałe są ignorowane. |
Specyfikacja OpenAPI 3.0 obsługuje wyłącznie adresy URL w polu Warunki świadczenia usług. Podczas eksportowania definicji w OAS 3.0 to pole jest eksportowane tylko wtedy, gdy zawiera adres URL. Jeśli tak nie jest, pole Warunki korzystania z usługi jest ignorowane, aby zapewnić poprawność definicji.