Apigee developer portal swagger version

saigurunath01 · 09-08-2022 10:31 AM

Hi

Is Apigee developer portal supports Swagger 3.x ? or openapi 3.0.0

dchiesa1

Apigee supports OpenAPI Specification 3.0 and 2.0 when you generate interactive API reference documentation using SmartDocs on your portal .

saigurunath01

Hi @dchiesa1 @ravenhedden Thank you for replying.

We are using Apigee in private cloud and portal is also installed in sameway.

1. Portal in private cloud has also capability to use Openapi 3.x.x ? I believe currently smart docs module only accepting Swagger 2.0.

ravenhedden

To add on to what Dino said, Swagger still exists as a set of tools but OpenAPI is the actual specification now. The Swagger specification has been renamed to OpenAPI. You can read more about Swagger vs OpenAPI in Swagger documentation here

anilmoregfs

The API Portal does not show form parameters if the request content type is

multipart form-data. Is this a bug? It shows correctly on Swagger Editor or any other openapi spec editor, but it does not show on the Apigee integrated portal.

hartmann

Hello,

I would recommend reviewing the following thread: https://www.googlecloudcommunity.com/gc/Apigee/OpenAPI-spec-with-multipart-form-data/m-p/780654/high... which notes that the functionality requested is currently not possible and it is a feature currently being prioritized in our backlog.

Once we know more I will be sure to update accordingly - thanks!