Transformationer vid exportera
Senast uppdaterad: 2026-10-20När en definition som har utformats med funktioner för API Contracts exporteras till ett format som inte stöder dem, ändras definitionen för att passa målformatet. Viss uttrycksförmåga går förlorad i processen.
Tabellen nedan beskriver de ändringar som görs i din API-definition vid export i en av följande specifikationer:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Funktion som inte stöds | Omvandling |
|---|---|
| Komponenter | Komponenten kopieras på 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 hos 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 övriga ignoreras. |
OpenAPI Specification 3.0 stöder endast URL:er i fältet Användarvillkor. När en definition exporteras i OAS 3.0 exporteras detta fält endast om det innehåller en URL. Om det inte gör det ignoreras fältet Användarvillkor för att säkerställa definitionens giltighet.