O Endpoints é um sistema de gestão de APIs distribuído. Oferece uma consola de API, alojamento, registo, monitorização e outras funcionalidades para ajudar a criar, partilhar, manter e proteger as suas APIs. Esta página oferece uma vista geral do Cloud Endpoints para gRPC. Para obter informações sobre outros tipos de frameworks de API suportados pelos Endpoints, consulte Todos os documentos dos Endpoints.
O Endpoints está disponível para utilização com o proxy de serviço extensível (ESP) distribuído ou o proxy de serviço extensível V2 (ESPv2). Cada proxy oferece suporte às plataformas descritas abaixo:
- App Engine Flexible (apenas ESP)
- Google Kubernetes Engine (ESP ou ESPv2)
- Compute Engine (ESP ou ESPv2)
- Kubernetes (ESP ou ESPv2)
- App Engine standard (apenas ESPv2)
- Funções do Cloud Run (apenas ESPv2)
- Cloud Run (apenas ESPv2)
- Knative serving (apenas ESPv2)
Pontos finais com SEP
O Endpoints usa o proxy de serviço extensível (ESP) distribuído para oferecer baixa latência e alto desempenho para publicar até mesmo as APIs mais exigentes. O ESP é um proxy de serviço baseado no NGINX, pelo que pode ter a certeza de que é dimensionado conforme necessário para processar pedidos simultâneos à sua API. O ESP é executado no seu próprio contentor Docker para um melhor isolamento e escalabilidade, e é distribuído no registo de contentores. Pode usá-lo com:
Pontos finais com ESPv2
O ESPv2 é um proxy escalável de alto desempenho baseado no Envoy que é executado à frente de um back-end de API OpenAPI ou gRPC. O ESPv2 suporta a versão 2 da especificação OpenAPI e das especificações gRPC. Pode usá-lo com:
Funcionalidades de gestão da API Endpoints
Quer use os Endpoints com o ESP ou o ESPv2, estes oferecem várias funcionalidades de gestão de APIs significativas que lhe permitem desenvolver, monitorizar e controlar o acesso às suas APIs.
Registos e métricas
Os Endpoints usam a infraestrutura de serviços para gerir APIs e comunicar registos e métricas. A maioria das Google Cloud APIs usa esta mesma infraestrutura. Pode gerir e monitorizar as suas APIs na página Serviços de pontos finais na Google Cloud consola.
Alojamento de APIs
O Endpoints está otimizado para o ambiente de contentores do Docker. Pode alojar a sua API em qualquer lugar onde o Docker seja suportado, desde que tenha acesso à Internet para Google Cloud.
Desenvolver uma API gRPC com pontos finais
Defina um serviço de API gRPC através de protocol buffers e implemente-o em qualquer linguagem suportada pelo gRPC.
Escreva a configuração do serviço da API gRPC para os Endpoints.
Gere a configuração da API de tempo de execução para a sua API e implemente-a na gestão de serviços.
Implemente o servidor da API.
Pode saber mais sobre a utilização do gRPC com os Endpoints em Endpoints para APIs gRPC e nos tutoriais relevantes.
Controlar o acesso à API
Os pontos finais permitem-lhe configurar a sua API para exigir uma chave da API para qualquer chamada e validam a chave da API. Também pode usar a Google Cloud consola para partilhar a sua API com outros programadores para que possam ativar a sua API e gerar chaves da API para a chamar.
Autenticação de utilizadores da API
Para a maioria das chamadas de API, existe um utilizador do outro lado de cada chamada. Embora as chaves da API indiquem que app está a fazer uma chamada à sua API, o processo de autenticação determina que utilizador está a usar essa app.
Tenha em atenção que o servidor da API continua a ter de decidir o que o utilizador autenticado pode fazer com a sua API. Para mais informações, consulte o Google Cloud guia de autorização.
O que se segue?
Familiarize-se com os passos de implementação e veja as funcionalidades dos Endpoints em ação através do início rápido dos Endpoints, que usa scripts para implementar uma API de exemplo num back-end flexível do App Engine.
Saiba como usar os Endpoints seguindo um dos tutoriais.