The AWS API gateway service allows importing of an OpenAPI specification to create a REST API. The process is very straightforward and can be found here. Here are some tips to consider when importing the documentation:
- Remove any circular dependencies (these aren’t supported by the parser).
- Remove security-related annotations (These annotations aren’t well supported by the parser).
- Max length of fields are reviewed by the parser but the errors aren’t self-explanatory. Review the specification to verify that the requirements are met.
- API gateway errors aren’t great, but you can use this page for structure validation.