Since OAS 3.0 is not yet supported with the Drupal Developer Portal SmartDocs module, what is the official recommendation for customers who do not intend to use the Integrated Portal.
I understand that there is the 'swagger-ui' but it isn't officially supported.
Thanks,
Shshank
Solved! Go to Solution.
The new Drupal 8 based portal does support OAS 3.0, though I can't find an easy spot where this is documented.
Check that, It's documented here: https://docs.apigee.com/api-platform/publish/developer-portal#feature-comparison. The "Drupal" column refers to the Drupal 8 version.
Portal code: https://www.drupal.org/project/apigee_devportal_kickstart
Documentation: https://www.drupal.org/docs/8/modules/apigee-developer-portal-kickstart
The new Drupal 8 based portal does support OAS 3.0, though I can't find an easy spot where this is documented.
Check that, It's documented here: https://docs.apigee.com/api-platform/publish/developer-portal#feature-comparison. The "Drupal" column refers to the Drupal 8 version.
Portal code: https://www.drupal.org/project/apigee_devportal_kickstart
Documentation: https://www.drupal.org/docs/8/modules/apigee-developer-portal-kickstart
Thanks @Karl Scheirer
Is that (OAS3) part of SmartDocs model support ?
I ask because the explanation does not clearly say if we can create SmartDocs models using OAS3.0 specs.
I see that we can enable the new API Catalog module in Drupal8, with which an "API Doc" can be created and can point to the SmartDocs API.
Does this mean we now need to create the API Doc page (if needed) in addition to the SmartDocs model ?
Thanks,
Shshank
In the new portal SmartDocs == Api Doc, and there is no model anymore. You just upload your OpenAPI file, and then its rendered at view time, there's no separate render step.
This version of SmartDocs/Api Doc supports OAS3.
Thank you for the confirmation @Karl Scheirer
Does integrated developer portal supports OAS 3.0?
, @Karl Scheirer is right about Drupal 8-based "Api Catalog" module supporting OAS3. You can find the documentation about this module at : https://www.drupal.org/project/apigee_api_catalog
Let us know if this helps.
-Arun
Thank you @arungopal