Step 8 - Publish API v2.0

The API Team performs these actions.

Upload OpenAPI Spec file Version 2

  1. In NMS ACM, in Services (the API Team environment), go to your workspace sentence-app

  2. In API Docs, click Add API Doc then upload oas-sentence-v2.yaml``from the Win10 Desktop and click ``Save.

    Note

    You can now see 2 OpenAPI specification files

    ../../../_images/doc-v2.png

  3. In API Proxies, notice the version of the existing proxy sentence-api. It is v1.

    ../../../_images/proxy-v1.png

  4. Edit the sentence-api by clicking on the three dots on the top right of the row and clicking Edit Proxy.

  5. Now, in the Configuration section, select api-sentence-generator-v2 as the API Spec

    ../../../_images/oas-v2.png

  6. Click Save & Publish

    Note

    A new line is created with version v2

    ../../../_images/proxy-v2.png

    Note

    As a reminder, the API Gateway exposes the API with the /version/basepath scheme. It means the new path for Version 2 is /v2/api/