awslabs / aws-api-gateway-developer-portal

A Serverless Developer Portal for easily publishing and cataloging APIs
Apache License 2.0
927 stars 399 forks source link

Open Api 3.0 - allOf not supported by the portal ? #435

Open Emmanuel-D-coface opened 3 years ago

Emmanuel-D-coface commented 3 years ago

Hi,

I use portal version 4.0.3 In order to overload some description fields , we use allOf instruction (which is part of the open api 3.0 specification) in our yaml. It does not pose problems at import, I can see it in the models in the api gateway , so the JSON schema is ok. From the api gateway I can generate SDKs.

But when I open the documentation in the dev portal, the allOf fields do not appear , and all sdk generation fails.

It is known that discriminator and oneOf are not supported by API gateway, but there is nothing about allOf.

When I open the documentation with the normal version of swaggerUI or redoc, I can see my allOf fields. so there's something either with the swaggerui react plugin or the react part of the portal .

It's a blocking point to the production delivery since the documentation exposed is not complete.

Do you plan to upgrade swagger version ?

thanks for your help.