How can I create a swagger spec for an existing API Proxy?

[ia1011]

I have created an API proxy before. Now I want to create a swagger spec for that. How can I do that?

[strebel]

There's a community tool https://github.com/anil614sagar/apigee2openapi that lets you generate openapi specs from a proxy bundle.

Note: If you're using Apigee x/hybrid you'll need to download the bundle and use the local reference to generate the spec because the built-in download only targets Apigee Edge.

[ia1011]

After downloading the apigee2openapi what would be the next step?

[strebel]

Please see the instructions in the Repo readme:

$ sudo npm install -g apigee2openapi
$ apigee2openapi -d ~/Documents/GlobalWeather -l ~/Documents/GlobalWeather.zip -n GlobalWeather -e https://msebai-test.apigee.net

Or the detailed instructions here: https://www.googlecloudcommunity.com/gc/Cloud-Product-Articles/apigee2openapi-A-Node-Js-command-line...

[API-Evangelist]

General opinion you should start thinking on below

1. API Contract design/review

2. Have some kind of api assessment done for the contract

3. Create proxies based of the contract

4.Validate via  https://docs.apigee.com/api-platform/reference/policies/oas-validation-policy with in the proxy (possible).

Never tested other way around ..

[Roaa]

Try to use this tool

https://inspector.swagger.io/builder