Drupal 8 Dev portal API publishing with maven

Is there any option similar to the maven smartdocs plugin to publish API docs to the API Catalog on Drupal 8 developer portal?

Solved Solved
1 10 506
1 ACCEPTED SOLUTION

@Nagashree B

Just released the Maven plugin for Drupal 8 developer portal. Check out this post. Since you already have the module installed in your portal, you will need to update it as the plugin required a change to the module to support filtering. The command to update the module using composer is

composer update drupal/apigee_api_catalog --with-dependencies --optimize-autoloader

Try the plugin and let me know if you have any issues. Please raise it in Github itself

View solution in original post

10 REPLIES 10

@Nagashree B - nothing yet. Working on it

Are there any management APIs on OPDK that can be used for publishing as an alternate option?

@Nagashree B

- Check this out

@Sai Saran Vaidyanathan Yes, I have checked that and able to upload the docs as well, but having a hard time figuring out how to update the docs through the CI/CD using these APIs.

@Nagashree B

Am working on the plugin. Will update once its released

@Nagashree B

Just released the Maven plugin for Drupal 8 developer portal. Check out this post. Since you already have the module installed in your portal, you will need to update it as the plugin required a change to the module to support filtering. The command to update the module using composer is

composer update drupal/apigee_api_catalog --with-dependencies --optimize-autoloader

Try the plugin and let me know if you have any issues. Please raise it in Github itself

@Sai Saran Vaidyanathan

Thank you for updating me on this.

I am using the Apigee kickstart devportal and trying to push the API documentation.

I am seeing a 404 error.

1. I can't get to this URL from postman as well

http://xxxx/ApigeeDevPortal/web/user/login.json or

http://xxxxx/ApigeeDevPortal/web/jsonapi/user/login.json

2. I see that the JsonApis-extra module already has /jsonapi set. Should the same be used for

portal.path ?

I am not sure if this is an issue with the plugin or incorrect configuration from my side, so not logging it in GitHub.

@Nagashree B

Not sure what you mean by portal.path. For the Drupal 8, there is no portal.path param. Please check the sample in the repo (https://github.com/apigee/apigee-smartdocs-maven-plugin/blob/master/samples/Drupal8/DevPortal/pom.xm...)

You only need the modules installed (as mentioned in the Pre-reqs)

Thanks, I had it from my previous drupal7 POM file. I tried running the sample, and I am seeing a 415 Unsupported media type error. Posting it on GitHub.