OAS 3.0 Portal recommendation

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 Solved
1 7 599
1 ACCEPTED 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

View solution in original post

7 REPLIES 7

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?

@Shshank Mathur

, @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