The OpenAPI Specification (OAS), formerly known as Swagger, is a specification for building APIs. OpenAPI defines a standard, programming language-agnostic interface description for RESTful APIs, which allows both humans and computers to understand the capabilities of a service without accessing its source code or seeing further documentation.
Apiable supports synchronizing OAS/Swagger documents stored within the Amazon API Gateway.
In order to do so, first make sure the Product Plan you are working with has APIs that are coming from the Amazon API Gateway.
Next, navigate to the Documentation tab, and for the API you want to retrieve the specification, select the "Gateway Synchronization" radio button.
Clicking on the "Fetch Latest Version" link will retrieve the API Specification directly from the connected Amazon API Gateway.
Caution: "Fetch Latest Version" will always get the latest version of the documentation from Amazon and will overwrite the existing API Specification. Use "+ Add new version" to create a new version of the API Specification before synchronizing.
Note: If you have not uploaded an API Specification for this API, Amazon will generate one for you based upon the API Schema.