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 OpenAPI. 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:
- Ambiente padrão do App Engine
- Compute Engine
- Google Kubernetes Engine
- Kubernetes
- Cloud Run
- Knative serving
- Funções do Cloud Run
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 REST com pontos finais para a OpenAPI
Os pontos finais são independentes do idioma. Cria a sua API em qualquer linguagem e framework REST que suporte a descrição de APIs através de um ficheiro de configuração da OpenAPI.
Para usar os Endpoints para OpenAPI:
Configurar pontos finais: descreve a superfície da API e configura funcionalidades dos pontos finais, como chaves de API ou regras de autenticação, num ficheiro de configuração OpenAPI.
Implemente a configuração do Endpoints: depois de definir a sua API num ficheiro de configuração OpenAPI, usa a Google Cloud CLI para a implementar na gestão de serviços, que o Endpoints usa para gerir a sua API. Agora, o Endpoints sabe tudo sobre a sua API e como a proteger.
Implemente o back-end da API: implemente o ESP ou o ESPv2 e o back-end da API num back-end suportado, como o Compute Engine. Google Cloud O ESP coordena-se com os serviços de back-end do Endpoints para proteger e monitorizar a sua API no tempo de execução.
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.