O Endpoints é um sistema de gerenciamento de APIs distribuído. Ele oferece console de APIs, hospedagem, geração de registros, monitoramento e outros recursos para ajudar você a criar, compartilhar, manter e proteger suas APIs. Nesta página, você terá uma visão geral do Cloud Endpoints para OpenAPI. Para mais informações sobre outros tipos de frameworks de API compatíveis com o Endpoints, consulte toda a documentação do Endpoints.
O Endpoints está disponível para uso com o Extensible Service Proxy (ESP) distribuído ou o Extensible Service Proxy V2 Beta (ESPv2 Beta). Cada proxy oferece suporte às plataformas descritas abaixo:
- Ambiente flexível do App Engine (somente ESP)
- Google Kubernetes Engine (ESP ou ESPv2)
- Compute Engine (ESP ou ESPv2)
- Kubernetes (ESP ou ESPv2)
- Padrão do App Engine (somente ESPv2)
- Funções do Cloud Run (somente ESPv2)
- Cloud Run (somente ESPv2)
- Knative serving (somente ESPv2)
Endpoints com o ESP
O Endpoints usa o Extensible Service Proxy (ESP) distribuído para oferecer baixa latência e alto desempenho, assim atendendo até as APIs mais exigentes. O ESP é um proxy de serviço baseado em NGINX (em inglês). Isso garante o escalonamento conforme as necessidades do usuário para processar solicitações simultâneas à API. O ESP é executado no próprio contêiner do Docker para oferecer melhor isolamento e escalonabilidade, além de ser distribuído no Container Registry. É possível usá-lo com o seguinte:
Endpoints com o ESPv2
O ESPv2 é um proxy escalonável de alto desempenho baseado no Envoy que é executado em um back-end de uma API OpenAPI ou gRPC. O ESPv2 é compatível com a versão 2 da especificação OpenAPI e das especificações do gRPC. É possível usá-lo com o seguinte:
- Ambiente padrão do App Engine
- Compute Engine
- Google Kubernetes Engine
- Kubernetes
- Cloud Run
- Knative serving
- Funções do Cloud Run
Recursos de gerenciamento da API Endpoints
O Endpoints pode ser usado com o ESP ou ESPv2 Beta, oferecendo vários recursos significativos de gerenciamento de API para permitir que você desenvolva, monitore e controle o acesso às APIs.
Registros e métricas
O Endpoints usa o Service Infrastructure para gerenciar APIs e gerar relatórios de registros e métricas. A maioria das APIs do Google Cloud usa essa mesma infraestrutura. É possível gerenciar e monitorar as APIs na página Serviços do Endpoint no Console do Google Cloud.
Hospedagem de API
O Cloud Endpoints é otimizado para o ambiente de contêiner do Docker. É possível hospedar sua API em qualquer lugar em que o Docker seja compatível, desde que tenha acesso de Internet ao Google Cloud.
Como desenvolver uma API REST com o Endpoints para OpenAPI
O Endpoints não depende de linguagens. Você desenvolve a API em qualquer linguagem e framework REST compatível com a descrição dela usando um arquivo de configuração do OpenAPI.
Para usar o Endpoints para OpenAPI, você precisa:
Configurar o Endpoints: descreva a superfície da API e configure os recursos do Endpoints, como chaves de API ou regras de autenticação, em um arquivo de configuração da OpenAPI.
Implante a configuração do Endpoints: depois de definir os em um arquivo de configuração OpenAPI, você usa a Google Cloud CLI para implantá-la ao Service Management, que o Endpoints usa para gerenciar API. Agora, o Endpoints sabe tudo sobre sua API e como protegê-la.
Como implantar o back-end da API : implante o ESP ou o ESPv2 e o back-end da API em um back-end compatível do Google Cloud, como o Compute Engine. O ESP coordena com os serviços de back-end do Endpoints para proteger e monitorar a API no ambiente de execução.
Como controlar o acesso à API
Com o Endpoints, é possível configurar a API para exigir uma chave de API nas chamadas e validá-la. Também é possível usar o console do Google Cloud para compartilhar a API com outros desenvolvedores. Assim, eles podem ativar a API e gerar chaves para chamá-la.
Autenticar usuários da API
Na maioria das chamadas de API, há um usuário na outra extremidade. As chaves de API indicam o app que faz uma chamada para sua API, e o processo de autenticação identifica o usuário que está utilizando esse app.
Seu servidor de API ainda precisa definir o que o usuário autenticado pode fazer com a API. Para mais informações, consulte o guia de autenticação do Google Cloud.
A seguir
Para se familiarizar com as etapas de implantação e ver como os recursos do Endpoints funcionam, execute o Guia de início rápido do Cloud Endpoints, que usa scripts para implantar uma API de amostra em um back-end flexível do App Engine.
Para saber mais sobre como usar o Endpoints, acesse os tutoriais.