Umwandlungen beim Export
Letzte Aktualisierung: 20.10.2026Beim Exportieren einer Definition, die mit API Contracts-Funktionen entworfen wurde, in ein Format, das diese nicht unterstützt, wird die Definition angepasst, um dem Zielformat zu entsprechen. Dabei geht etwas Ausdruckskraft verloren.
Die folgende Tabelle beschreibt die Änderungen, die an Ihrer API-Definition vorgenommen werden, wenn sie in eine der folgenden Spezifikationen exportiert wird:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Nicht unterstützte Funktion | Umwandlung |
|---|---|
| Komponenten | Die Komponente wird an jeder Stelle kopiert, an der sie verwendet wird. |
| Antwortbereiche und Standardantworten | Die Antwort wird entfernt. |
| Bearer-Authentifizierung und OpenID Connect | Das Sicherheitsschema wird entfernt. |
| allOf-Kombinationen | Die Kombination wird durch ein Objekt ersetzt, das alle Eigenschaften aller verwendeten Typen enthält. |
| anyOf- und oneOf-Kombinationen | Die Kombination wird durch ein leeres Objekt ersetzt. |
| Mehrere Endpunkte | Der erste veröffentlichte Endpunkt wird in die Definition eingeschlossen, die anderen werden ignoriert. |
OpenAPI Specification 3.0 unterstützt nur URLs im Feld Servicebedingungen. Beim Exportieren einer Definition in OAS 3.0 wird dieses Feld nur exportiert, wenn es eine URL enthält. Andernfalls wird das Feld Servicebedingungen ignoriert, um die Gültigkeit der Definition zu gewährleisten.