Amazon AWS API Gateway claims that is compatible with Swagger. I don't think so, just the Swagger format version 2 it is supported.
Swagger 2 evolved to Openapi 3, and fame and fortune is all for him.
But the poor souls that want to use the (almost) amazing API Gateway have to wait that Amazon guys include the new format.
Until that happen, I'm glad to anounce:
I really didn't do anything, I've just combined the great work of other people, in particular: LucyBot-Inc/api-spec-converter
This repo has a Dockerfile that create a container with the hability of convert a Openapi3 spec file and convert it in a Swagger2 file, compatible with AWS API Gateway.
It works directly out of the box.
docker build -t openapi2swagger:latest .
docker run -v /directory/where/is/the/file:/tmp -e OPENAPI_FILE=the_openapi3_file.json openapi2swagger:latest > ~/swagger2_file.json- /directory/where/is/the/file : the directory on your computer where is the Openapi3 file spec.
- the_openapi3_file.json : the file name.
I don't know yet why API Gateway doesn't support this property in the Swagger spec. The command inside the docker removes those lines with a bash sed command.
Any clue is welcome.