Integration of developer portal with api spec repo

[santosh_ghalsas]

Hi @Anil Sagar @ Google

Do we have any provision to push API specs from a repository, say git, to Apigee developer portal? I just wanted to explore options to include the spec uploading activity in the CI/CD pipeline. We can keep the publishing activity manual so that dev portal admin can have control on when to publish this to app developers on the portal. This is to avoid any manual errors and achive CI/CD in terms of developer portal as well.

Appreciate any pointers here.

Regards,

Santosh

[karlscheirer · Accepted solution]

@santosh

Install and enable this module: https://github.com/apigeecs/smartdocs_service

It will create REST endpoints on your devportal that can accept a swagger doc for import and rendering.

[santosh_ghalsas]

Hi @Karl Scheirer,

Thank you so much for your help. I guess the curl commands can be used in any automation tool like jenkins to push the specs from a spec repo to the portal. Does this module support only Drupal based devportals or new devportals as well? Also does this module takes care of incrementing revision of the spec if we are uploading same spec but with updated definitions?

Best,

Santosh

[karlscheirer]

Hello,

The module only supports Drupal 7-based developer portals. But yes, it will handle revisions for you.