Management Server API for fetching uploaded Swagger/API Specification file

Hello,

I am currently uploading the Swagger/API specs with the following Management API call.

v1/organizations/nonprod/apimodels/xxxx/import/file

Is there an management api call available to fetch (GET) the uploaded API/Swagger Spec?

Note: The API/Swagger spec should be fetched as it's uploaded originally. Currently, I can download only in the Internal SmartDoc Json format, not the originally uploaded file.

0 1 327
1 REPLY 1

No but I am not sure though. Here are a few points to note.

If you are not doing this yet, a better way to publish a spec to the portal is the smartdocs maven plugin

https://github.com/apigee/apigee-smartdocs-maven-plugin

https://github.com/apigee/apigee-smartdocs-maven-plugin/tree/master/samples

The larger problem of spec management is an interesting area and you have two options.

1) Apigee itself is a great tool to collaborate on your spec and hence is a great place to track your spec. You can get API developers have a single catalog view of all your specs using their existing Apigee account.

https://docs-new.apigee.com/manage-specs

2) Your SCM (git etc.,)

You can collaborate on your spec using your favourite source control system so that it aligns with the rest of your code history. You can use the smartdocs plugin given above to then publish it to the portal.