Transformaties bij exporteren
Wanneer u een definitie die is ontworpen met API Designer-functies exporteert naar een indeling die deze niet ondersteunt, wordt de definitie gewijzigd zodat deze in de doelindeling past. Hierbij gaat enige expressiviteit verloren.
De onderstaande tabel beschrijft de wijzigingen die in uw API-definitie worden aangebracht bij het exporteren in een van de volgende specificaties:
- OAS/Swagger 2.0
- Swagger 1.2
- RAML 1.0
| Niet-ondersteunde functie | Transformatie |
|---|---|
| Componenten | De component wordt gekopieerd naar elke plaats waar deze wordt gebruikt. |
| Responsbereiken en standaardresponsen | De respons wordt verwijderd. |
| Bearer-authenticatie en OpenID Connect | Het beveiligingsschema wordt 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 wordt opgenomen in de definitie, de andere worden genegeerd. |
OpenAPI Specification 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 garanderen.