Transformationer vid export
När du ska exportera en definition som utformats med API Designer-funktioner i ett format som inte stöder dem, ändras definitionen för att passa målformatet. Viss uttrycksfullhet går förlorad i processen.
Tabellen nedan beskriver de ändringar som görs i din API-definition när du ska exportera i en av följande specifikationer:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Funktion som inte stöds | Transformation |
|---|---|
| Komponenter | Komponenten kopieras till varje plats där den används. |
| Svarsintervall och standardsvar | Svaret tas bort. |
| Bearer-autentisering och OpenID Connect | Säkerhetsschemat tas bort. |
| allOf-kombinationer | Kombinationen ersätts med ett objekt som innehåller alla egenskaper för alla typer som används. |
| anyOf- och oneOf-kombinationer | Kombinationen ersätts med ett tomt objekt. |
| Flera slutpunkter | Den första publicerade slutpunkten inkluderas i definitionen, de andra ignoreras. |
OpenAPI Specification 3.0 stöder endast webbadresser i fältet Användarvillkor. När du ska exportera en definition i OAS 3.0 exporteras detta fält endast om det innehåller en webbadress. Om det inte gör det ignoreras fältet Användarvillkor för att säkerställa definitionens giltighet.