Transformationen beim Export
Beim Export einer mit Funktionen von Talend Cloud API Designer erstellten Definition in einem Format, das diese Funktionen nicht unterstützt, wird die Definition angepasst, sodass sie dem Zielformat entspricht. Bei diesem Prozess geht ein Teil der Expressivität verloren.
In der nachstehenden Tabelle werden die Änderungen beschrieben, die beim Export in einer der folgenden Spezifikationen an Ihrer API-Definition vorgenommen werden:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Nicht unterstützte Funktion | Transformation |
|---|---|
| Komponenten | Die Komponente wird an alle Stellen kopiert, an denen sie verwendet wird. |
| Antwortbereiche und Standardantworten | Die Antwort wird entfernt. |
| Bearer-Authentifizierung und OpenID Connect | Das Sicherheitsschema wird entfernt. |
| allOf-Kombinationen (Alle von) | Die Kombination wird durch ein Objekt ersetzt, das alle Eigenschaften aller verwendeten Typen enthält. |
| anyOf- und oneOf-Kombinationen (Beliebige von / Einer von) | Die Kombination wird durch ein leeres Objekt ersetzt. |
| Mehrere Endpunkte | Der erste veröffentlichte Endpunkt wird in die Definition aufgenommen, die anderen werden ignoriert. |
Die OpenAPI Specification 3.0 unterstützt nur URLs im Feld Terms of service (Servicebedingungen). Beim Export einer Definition in OAS 3.0 wird dieses Feld nur exportiert, wenn es eine URL enthält. Andernfalls wird das Feld Terms of service (Servicebedingungen) ignoriert, um die Gültigkeit der Definition sicherzustellen.