API Gateway

Conceitos introdutórios

1. Route(Rotas): são os caminhos que a nossa API pode tomar a depender da informação que ela recebe. Cada caminho é responsável por indicar uma ação diferente que a API irá executar e o que ela deve retornar

2. Métodos: temos alguns métodos em que as rotas serão estruturadas. Segue abaixo alguns métodos existentes para requisições HTTP:

   • GET: indica que o tipo de ação da rota é de retornar dado armazenado para o usuário

   • POST: indica que a rota será responsável por criar novos dados

   • DELETE: indica que a rota irá apagar algum dado existente

O serviço API Gateway tem como finalidade auxiliar os desenvolvedores a criarem API’s de forma simplificada e utilizando o formato serveless. Tem como possibilidade integrar-se com o serviço AWS Lambda chamando as funções e retornando para os clientes o resultado dela, além de poder se conectar com vários backends diferentes.

Apresenta versionamento e deployment de APIs e suas versões de forma fácil e intuitiva para o usuário.

Tipos de API

Podemos criar 3 tipos de API a depender da nossa necessidade:

1. RestAPI

2. HTTP API

3. WebSocket API

Para saber mais sobre cada uma delas recomendamos o curso gratuito da AWS sobre o API Gateway. Entre no Skill builder da aws e pequise por: Amazon API Gateway for Serverless Applications.

Criando uma API HTTP

Vamos ver agora passo a passo como criar uma API HTTP para podermos termos uma noção melhor como esse serviço funciona e como podemos integrá-lo com a função Lambda criada anteriormente:

• Procurar o API GATEWAY: procure no console o API GATEWAY

• Escolha a seguinte opção: API HTTP, clique em compilar

• Dar um nome para a API:

• Pule o passo de criar rotas: iremos fazer mais tarde esse processo.

• Colocar o Auto-Deploy como ligado(para projetos menores sem necessidade de versionamento tão fino)

• Clique em criar API

• Criar rotas: criaremos uma rota com o método GET e que terá o nome como /desenha

• Integração do tipo Lambda: após criarmos a rota iremos voltar para a página anterior, selecionamos /desenha e o método GET. Mais a direita teremos o botão attach integration, clique nele para adicionarmos a integração com a função lambda que criamos anteriormente.

• Selecione a função Lambda

• Crie a integração

  Agora temos a interação entre os dois serviços. Para testar se está mesmo funcionando corretamente vamos na parte de deploy:

Selecionamos $default e copiamos a URL da API que aparecerá ao lado:

A URL da API será do seguinte formato:

http://(id da api).execute-api.(região onde teve o deploy da API).amazonaws.com

Testar

Pegue a URL da API e adicione ao final a seguinte descrição:

(URL da API)/desenha?caracter_desenho=*&largura_piramide=10

Resultado esperado: