Transformaties bij exporteren
Laatst bijgewerkt: 09-10-2026Bij het exporteren van een definitie die is ontworpen met functies van API Contracts in een indeling die deze niet ondersteunt, wordt de definitie aangepast aan de doelindeling. Er gaat enige expressiviteit verloren in het proces.
De onderstaande tabel beschrijft de wijzigingen die zijn aangebracht in uw API-definitie bij het exporteren naar een van de volgende specificaties:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Niet-ondersteunde functie | Transformatie |
|---|---|
| Componenten | De component wordt gekopieerd op elke plaats waar deze wordt gebruikt. |
| Antwoordbereiken en standaardantwoorden | Het antwoord is verwijderd. |
| Bearer-authenticatie en OpenID Connect | Het beveiligingsschema is verwijderd. |
| allOf-combinaties | De combinatie wordt vervangen door een object dat alle eigenschappen van alle gebruikte typen bevat. |
| anyOf- en oneOf-combinaties | De combinatie wordt vervangen door een leeg object. |
| Meerdere eindpunten | Het eerste gepubliceerde eindpunt is opgenomen in de definitie, de overige worden genegeerd. |
OpenAPI-specificatie 3.0 ondersteunt alleen URL's in het veld Servicevoorwaarden. Bij het exporteren van een definitie in OAS 3.0 wordt dit veld alleen geëxporteerd als het een URL bevat. Als dit niet het geval is, wordt het veld Servicevoorwaarden genegeerd om de geldigheid van de definitie te waarborgen.