

# O que é o Amazon API Gateway?
<a name="welcome"></a>

O Amazon API Gateway é um serviço da AWS para criação, publicação, manutenção, monitoramento e proteção de APIs REST e WebSocket em qualquer escala. Os desenvolvedores de API podem criar APIs que acessem a AWS ou outros web services, bem como dados armazenados na [Nuvem AWS](https://aws.amazon.com/what-is-cloud-computing/). Como um desenvolvedor de APIs do API Gateway, é possível criar APIs para uso em suas próprias aplicações cliente. Ou você pode disponibilizar suas APIs para desenvolvedores de aplicativos de terceiros. Para obter mais informações, consulte [Quem usa o API Gateway?](api-gateway-overview-developer-experience.md#apigateway-who-uses-api-gateway).

O API Gateway cria APIs RESTful que:
+ São baseadas em HTTP.
+ Habilitam a comunicação cliente-servidor sem estado.
+ Implementam os métodos HTTP padrão, como GET, POST, PUT, PATCH e DELETE.

Para obter mais informações sobre APIs REST do API Gateway e APIs HTTP, consulte [Escolher entre APIs REST e APIs HTTP](http-api-vs-rest.md), [APIs HTTP do API Gateway](http-api.md), [Usar o API Gateway para criar APIs REST](api-gateway-overview-developer-experience.md#api-gateway-overview-rest) e [Desenvolver APIs REST no API Gateway](rest-api-develop.md).

O API Gateway cria APIs WebSocket que:
+ Seguem o protocolo [WebSocket](https://datatracker.ietf.org/doc/html/rfc6455), que permite a comunicação full-duplex entre cliente e servidor com estado.
+ Roteiam mensagens recebidas com base no conteúdo da mensagem.

Para obter mais informações sobre APIs WebSocket do API Gateway, consulte [Usar o API Gateway para criar APIs do WebSocket](api-gateway-overview-developer-experience.md#api-gateway-overview-websocket) e [Visão geral das APIs de WebSocket no API Gateway](apigateway-websocket-api-overview.md).

**Topics**
+ [Arquitetura do API Gateway](#api-gateway-overview-aws-backbone)
+ [Recursos do API Gateway](#api-gateway-overview-features)
+ [Casos de uso do API Gateway](api-gateway-overview-developer-experience.md)
+ [Acessar o API Gateway](#introduction-accessing-apigateway)
+ [Parte da infraestrutura sem servidor da AWS](#api-gateway-overview-a-serverless-pillar)
+ [Saiba como começar a usar o Amazon API Gateway](#welcome-how-to-get-started)
+ [Conceitos do Amazon API Gateway](api-gateway-basic-concept.md)
+ [Escolher entre APIs REST e APIs HTTP](http-api-vs-rest.md)
+ [Começar a usar o console da API REST](getting-started-rest-new-console.md)

## Arquitetura do API Gateway
<a name="api-gateway-overview-aws-backbone"></a>

O diagrama a seguir mostra a arquitetura do API Gateway.

![Diagrama da arquitetura do API Gateway](http://docs.aws.amazon.com/pt_br/apigateway/latest/developerguide/images/Product-Page-Diagram_Amazon-API-Gateway-How-Works.png)


Este diagrama ilustra como as APIs criadas no Amazon API Gateway proporcionam a você ou a seus clientes desenvolvedores uma experiência de desenvolvedor integrada e consistente para criar aplicações sem servidor da AWS. O API Gateway processa todas as tarefas relacionadas à aceitação e ao processamento de até centenas de milhares de chamadas simultâneas de APIs. As tarefas incluem gerenciamento de tráfego, controle de autorização e acesso, monitoramento e gerenciamento de versão de APIs. 

O API Gateway atua como uma “porta frontal” para aplicações acessarem dados, lógica de negócios ou funcionalidade de seus serviços de backend, como cargas de trabalho executadas no Amazon Elastic Compute Cloud (Amazon EC2), código executado no AWS Lambda, qualquer aplicação Web ou aplicações de comunicação em tempo real.

## Recursos do API Gateway
<a name="api-gateway-overview-features"></a>

O Amazon API Gateway oferece recursos como os seguintes:
+ Suporte para APIs com estado ([WebSocket](apigateway-websocket-api.md)) e sem estado ([HTTP](http-api.md)) e [REST](apigateway-rest-api.md).
+ Mecanismos de [ autenticação](apigateway-control-access-to-api.md) poderosos e flexíveis, como políticas do , funções do autorizador do e grupos de usuários do AWS Identity and Access Management.
+ [Implantações de versão Canary](canary-release.md) para lançar alterações com segurança.
+ Registro em log e monitoramento do [CloudTrail](cloudtrail.md) do uso e alterações de API.
+ Registro de acesso em logs e registro de execução em logs do CloudWatch, incluindo a capacidade de definir alarmes. Para obter mais informações, consulte [Monitorar a execução da API REST com métricas do Amazon CloudWatch](monitoring-cloudwatch.md) e [Monitorar a execução de APIs de WebSocket com métricas do CloudWatch](apigateway-websocket-api-logging.md).
+ Capacidade de usar modelos do CloudFormation para permitir a criação de APIs. Para obter mais informações, consulte [Referência de tipos de recursos do Amazon API Gateway](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_ApiGateway.html) e [Referência de tipos de recursos do Amazon API Gateway V2](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_ApiGatewayV2.html).
+ Suporte para [nomes de domínio personalizados](how-to-custom-domains.md).
+ Integração ao [AWS WAF](apigateway-control-access-aws-waf.md) para proteger suas APIs contra explorações comuns da web.
+ Integração com latências de desempenho [AWS X-Ray](apigateway-xray.md) para compreensão e triagem.

Para obter uma lista completa das versões de recursos do API Gateway, consulte [Histórico do documento](history.md).

## Acessar o API Gateway
<a name="introduction-accessing-apigateway"></a>

É possível acessar o Amazon API Gateway das seguintes maneiras:
+ **Console de gerenciamento da AWS**: o Console de gerenciamento da AWS fornece uma interface da Web para criar e gerenciar APIs. Após concluir as etapas em [Configurar para usar o API Gateway](setting-up.md), você pode acessar o console do API Gateway em [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
+ **AWS SDKs**: se você estiver usando uma linguagem de programação para a qual a AWS fornece um SDK, você poderá usar um SDK para acessar o API Gateway. Os SDKs simplificam a autenticação, integram-se com facilidade ao ambiente de desenvolvimento e fornecem acesso aos comandos do API Gateway. Para mais informações, consulte [Ferramentas para a Amazon Web Services](https://aws.amazon.com/developer/tools/).
+ **APIs do API Gateway V1 e V2**: se você estiver usando uma linguagem de programação para a qual não haja SDK disponível, consulte a [Referência de API do Amazon API Gateway versão 1](https://docs.aws.amazon.com/apigateway/latest/api/API_Operations.html) e [Referência de API do Amazon API Gateway versão 2](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/api-reference.html).
+ **AWS Command Line Interface**: para obter mais informações, consulte [Noções básicas de configuração do AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/) no *Guia do usuário do AWS Command Line Interface*.
+ **AWS Tools for Windows PowerShell**: para obter mais informações, consulte [Noções básicas de configuração do AWS Tools for Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/) no *Guia do usuário do Ferramentas da AWS para PowerShell*.

## Parte da infraestrutura sem servidor da AWS
<a name="api-gateway-overview-a-serverless-pillar"></a>

Juntamente com o [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/), o API Gateway forma a parte voltada para a aplicação da infraestrutura sem servidor da AWS. Para saber mais sobre como começar a usar a tecnologia sem servidor, consulte o [Guia do desenvolvedor da tecnologia sem servidor](https://docs.aws.amazon.com/serverless/latest/devguide/welcome.html).

Para que uma aplicação chame serviços da AWS publicamente disponíveis, você pode usar o Lambda para interagir com os serviços necessários e expor as funções do Lambda por meio de métodos da API no API Gateway. O AWS Lambda executa seu código em uma infraestrutura de computação altamente disponível. Ele realiza a execução e a administração necessárias dos recursos de computação. Para habilitar aplicações sem servidor, o API Gateway oferece [suporte a integrações de proxy simplificadas](api-gateway-set-up-simple-proxy.md) com AWS Lambda e endpoints HTTP. 

## Saiba como começar a usar o Amazon API Gateway
<a name="welcome-how-to-get-started"></a>

Para obter uma introdução ao Amazon API Gateway, consulte o seguinte:
+ [Começar a usar o API Gateway](getting-started.md), que fornece uma demonstração para a criação de uma API HTTP.
+ [land sem servidor](https://serverlessland.com/video?tag=Amazon%20API%20Gateway), que fornece vídeos instrucionais.
+ [Happy Little API Shorts](https://www.youtube.com/playlist?list=PLJo-rJlep0EDFw7t0-IBHffVYKcPMDXHY), que é uma série de breves vídeos instrutivos.