Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You can manage multiple API versions simultaneously. The overview will always display scoring results for your most recently created version..

...

Create new Version

Press the three dots in the top right-hand corner. You can create a new version there. The appropriate Open Proxy Specification can then be uploaded as described below.

API Specification

Maximize API quality: Include a specification file with each version for automatic scoring against industry best practices (along with the ability to calculate a score against your own rulesets).

...

To edit the displayed API specification file, you can click on the pencil icon to the left of the line number. A new dialogue opens in which you can edit the file directly in the browser.
If you close the dialogue by clicking the 'X' button, your changes will not be applied.

...

Swagger UI

Each version displays the results of its specification file validation.

...

Open Proxy Specification

For APIs created in API Control Plane (not imported from a gateway), you can manage the Open Proxy Specification file.
Click on the “Open Proxy Specification” tab to view the file content.

...

Info

If you create an API via the 'API Control Plane Rest API' and do not specify a platform type, you can create a new version under Versions and manually upload an open proxy specification there. This turns the API into an Open Proxy API.

...

Edit Mode

You can use the 'Edit File' button to edit the displayed Open Proxy File directly in the browser.

...

If you close the dialogue by clicking the 'X' button, your changes will not be applied.

...

Settings

Here you can adjust the name and description of the version

...