Umwandlungen beim Export
Beim Exportieren einer mit API Designer-Funktionen entworfenen Definition in ein Format, das diese nicht unterstützt, wird die Definition an das Zielformat angepasst. Dabei geht ein Teil der Ausdrucksfähigkeit 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.