Desenvolver uma API HTTP no API Gateway - Amazon API Gateway
Criar uma API HTTP

Desenvolver uma API HTTP no API Gateway

Esta seção fornece detalhes sobre os recursos necessários do API Gateway durante o desenvolvimento de suas APIs do API Gateway.

Ao desenvolver a API do API Gateway, você decidirá uma série de características da API. Essas características dependem do caso de uso da sua API. Por exemplo, talvez você queira permitir que somente determinados clientes chamem sua API ou talvez queira disponibilizá-las a todos. É recomendável que uma chamada de API execute uma função do Lambda, faça uma consulta de banco de dados ou chame uma aplicação.

Tópicos

Criar uma API HTTP

Para criar uma API funcional, você deve ter pelo menos uma rota, integração, estágio e implantação.

Os exemplos a seguir mostram como criar uma API com uma integração de AWS Lambda ou HTTP, uma rota e um estágio padrão configurado para implantar alterações automaticamente.

Este guia pressupõe que você já está familiarizado com o API Gateway e o Lambda. Para obter uma lista mais detalhada, consulte Conceitos básicos do API Gateway

Crie uma API HTTP usando o AWS Management Console

  1. Abra o console do API Gateway.

  2. Selecione Create API (Criar API).

  3. Em HTTP API (API HTTP), escolha Build (Criar).

  4. Escolha Add integration (Adicionar integração) e, em seguida, escolha uma função do AWS Lambda ou insira um endpoint HTTP.

  5. Em Name (Nome), insira um nome para a sua API.

  6. Selecione Review and create.

  7. Escolha Create (Criar).

Agora sua API está pronta para invocar. Você pode testar sua API inserindo seu URL de invocação em um navegador ou usando Curl.

curl https://api-id.execute-api.us-east-2.amazonaws.com

Criar uma API HTTP usando a CLI da AWS

É possível usar a criação rápida para criar uma API com uma integração do Lambda ou HTTP, uma rota padrão genérica e um estágio padrão configurado para implantar alterações automaticamente. O comando a seguir usa criação rápida para criar uma API que se integra com uma função do Lambda no backend.

nota

Para invocar uma integração do Lambda, o API Gateway deve ter as permissões obrigatórias. Você pode usar uma política baseada em recursos ou uma função do IAM para conceder permissões do API Gateway para invocar uma função do Lambda. Para saber mais, consulte AWS Lambda Permissões no Guia do desenvolvedor do AWS Lambda.

aws apigatewayv2 create-api --name my-api --protocol-type HTTP --target arn:aws:lambda:us-east-2:123456789012:function:function-name

Agora sua API está pronta para invocar. Você pode testar sua API inserindo seu URL de invocação em um navegador ou usando Curl.

curl https://api-id.execute-api.us-east-2.amazonaws.com