SDK or code sample generation support for proxies

[skarlovic]

Does Apigee Edge or Developer Portal provide the ability for app developers to generate an SDK or sample code for the APIs they intend to consume? Or would the developer download the Swagger document via the portal and use Swagger Codegen to generate their own SDK? Thanks in advance.

[Former Community Member · Accepted solution]

It is a possible to write a drupal module that uses swagger-codegen and use it in the developer portal. In fact, @Anil Sagar is the author of such a custom module.

[anilsr]

We would suggest, "Prepare the Swagger document and use Swagger Codegen to generate your own SDK"

As said by @Srinandan Sridhar, In the past, we have done one Drupal Custom Module that does convert Swagger to SDK in portal. It's based on Swagger Codegen. I don't think that module is valid now since we no longer store swagger spec in developer portal, the moment you upload same Swagger Spec will be converted into intermediate spec called smartdocs json.

[skarlovic]

Thank you both. I have not yet had a chance to click around in the Developer Portal, does it provide a link for developers to download Swagger 2.0 specification? Is the format JSON, YAML or both?

[ssharp]

Both. The specification is here: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md

[skarlovic]

Thank you!

[anilsr]

@skarlovic , To be more clear, Apigee Developer Portal doesn't support generation of OpenAPI spec (Swagger 2.0) for your Apigee API Proxies. We have done an experimental module long back which is no longer valid. Apigee Developer Portal uses OpenAPI spec to generate interactive documentation called SmartDocs.

If you would like to generate Open API spec instead of writing it from scratch, take a look at our open source project apigee2openapi command line tool & our labs project OpenAPI Spec generator http://specgen.apistudio.io/

Keep us posted if any.

[skarlovic]

Thanks again.