# Desenvolver APIs REST usando OpenAPI no API Gateway
<a name="api-gateway-import-api"></a>

Você pode usar o API Gateway para importar uma API REST de um arquivo de definição externo para o API Gateway. No momento, o API Gateway é compatível com arquivos de definição [v2.0 da OpenAPI](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md) e [v3.0 da OpenAPI](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.1.md), com exceções listadas em [Notas importantes do Amazon API Gateway para APIs REST](api-gateway-known-issues.md#api-gateway-known-issues-rest-apis). É possível atualizar uma API substituindo-a por uma nova definição ou mesclar uma definição com uma API existente. As opções são especificadas usando um parâmetro de consulta `mode` no URL solicitado. 

Para obter um tutorial sobre o uso do recurso de importação de API no console do API Gateway, consulte [Tutorial: Criar uma API REST importando um exemplo](api-gateway-create-api-from-example.md).

**Topics**
+ [Importar uma API otimizada para bordas para o API Gateway](import-edge-optimized-api.md)
+ [Importar uma API regional para o API Gateway](import-export-api-endpoints.md)
+ [Importar um arquivo do OpenAPI para atualizar uma definição de API existente](api-gateway-import-api-update.md)
+ [Defina a propriedade `basePath` OpenAPI](api-gateway-import-api-basePath.md)
+ [AWS de variáveis para importação de OpenAPI](import-api-aws-variables.md)
+ [Erros e avisos ao importar a API para o API Gateway](api-gateway-import-api-errors-warnings.md)
+ [Exportar uma API REST do API Gateway](api-gateway-export-api.md)